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While the 
competition plays 
Catch-up, Borland 
C++ continues to 
lead with the most 
graphical ¢ and 
C++ for Windows, 
DOS, and OS/2. 


e Visual code generation for 
C and C++ for Windows 

e Best support for ANSI C and 
AT&T C++ standards 

e Easiest IDE for Windows, DOS, 
and OS/2 

e Fastest C and C++ compilation 

e Most popular C and C++, with 
more than one million sold 





*Available with Turbo C++ Visual Edition and Borland C++ & Application Frameworks for Windows and DOS. +ANSI C certified by the British Standards Institute. Copyright © 1993 Borland International, Inc. 
All rights reserved. All Borland product names are trademarks of Borland International, Inc. Offer good in the United States and Canada only. All prices in U.S. dollars. Dealer prices may vary. BI 5384.1 
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Turbo C++ 


for DOS Visual Edition for Windows and DOS for OS/2 Combines 
The easiest way to Windows Now you The world standard 32-bit power with 
start programming can visually generate professional C and C++, graphical ease in the 
in C and C++. C and C++ applica- includes code optimiza- world’s standard C 
tions in 3 easy steps! tions for building and C++ compiler. 
powerful applications. 


A more comfortable place 
to program 

Borland® C++ gives you the most 
intuitive Integrated Development 
Environment (IDE) for Windows, 
DOS, and OS/2.® You get your 
work done faster because the IDE 
is easy to learn and even easier to 
use. And Borland C++ includes 
C and C++ code generation and 
Application Frameworks.™ * the 
user interface libraries that C++ 
programmers prefer most. 


To set standards you must 
meet standards 


Borland C++ is the only popular 
compiler that meets the certified 
ANSI C# and AT&T C++ stan- 

dards. You can be confident that 
as the language evolves to make 








BORLAND C++ 
FOR WINDOWS AND DOS 
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‘*Let’s be honest. 
Microsoft® is good, but 


Borland is best.”’ 


—Michael Passalacqua, C++ programmer 





programming easier and more 
powerful, your Borland C++ code 
will be ready to take advantage of 


future versions across all platforms. 


What’s more, applications built 
with Borland C++ will deliver 
faster because you'll have the most 
advanced features—like templates 
that make your code smaller, safer, 
and more reusable. 


#1 for real-world 
application development 


With more than one million copies 
in active use, Borland’s C++ is 
polished and finely tuned to meet 
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BORLAND C++ 


& APPLICATION FRAMEWORKS 
FOR WINDOWS AND DOS 


BORLAND C++ 
SUCHIN AME WORKS 
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Frameworks for Windows and 
DOS Adds time-saving Application 
Frameworks to the power of Borland 
C++. It’s the complete C and C++ 
solution. 


the needs of C++ programmers. 
This is the only C++ that is proven 
to deliver large, real-world applica- 
tions—from companies like Aldus, 
Novell, WordPerfect, Hewlett- 
Packard, Borland, and more. 


Borland has the C++ 
that’s right for you 


Whether you're a top 





professional or just 
starting out, Borland 
C++ has the most 
intuitive tools to get [*) [*) 
Es 
ES 


90-day, money-back guarantee! 


your job done fast, in 
Windows, DOS, and 
now OS/2. 


a 
t 


| See your dealer or call now, | 
| 1-800-336-6464, ext. o988 | 


In Canada call, 1-800-461-3327 
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Power made easy 








“! couldn't finc 
that was affordable. Sc 


“I'm an engineer. And I know what it’ like to need a high- 
performance and easy-to-use CASE tool. One that I could 


afford to place on every project team member’s desk, not 


just a select few. That's why I developed System Architect™ 
As Chief Scientist at Popkin Software, my role is to bring 


the experiences of our developers to bear on the design of the 
best CASE tool possible. System Architect is the result.” 


Low Price/High Performance. 


Since its introduction in 1988, System Architect (SA) has 
proven that many of the features offered by more expensive 
CASE tools are available for a fraction of the cost. In fact, 
SA has several features that higher-priced products don’t 
have. It has proven that a technically aggressive company 
can produce a powerful, easy-to-use, flexible, affordable 
CASE tool. ‘There are over 15,000 SA copies in use at 3,000 
installations worldwide. And we're versatile enough to be 
used by large companies as well as small ones. 


Quick And Easy. 


System Architect works on IBM® and IBM-compatible PCs 


running MS Windows® or OS/2 PM®. It comes with an inte- 
grated data dictionary that users can customize to meet their 








‘scell needs. Project personnel can easily share 

ieee a8 information both on and off a network. It’s so 

° (2508 : 

55588 | user friendly that even from the first day you SSADM. And diagram types and charts such as: DFDs, 


MICROSOFT, Can sit down, get to work, and produce — Entity Relation diagrams, Decomposition diagrams, State 
WINDOWS. results. It’s the perfect solution for hands-on ‘Transition diagrams, Structure Charts, and Flow Charts. 


developers whose livelihood depends on their ability to pro- The Power To Grow 


— Wheth ding to advances in technology such 
: . ether responding to advances in technology such as 
Multiple Choice. te Client/ Server and Object Oriented 
Whether your application is targeted for a PC, a 3 >) | 
Mainframe or a Client/ Server environment, 
System Architect gives you a choice. SA also 
works with multiple 
methodologies such as: 


Yourdon/DeMarco, Gane 
& Sarson, Ward & Mel- 
lor (real-time), Booch, 
Shlaer/Mellor (OO), 
Coad/Yourdon, Informa- 
tion Engineering, and 









design or to our user requests, System 
Architect is the CASE tool that contin- 
ues to grow in functionality as well as 
productivity. Here are a few optional 
modules now being offered: 

SA Reverse Data Engineer: Pro- 


A Bring existing SQL data- vides reverse engineering of Windows 
bases into a CASE environ- di ql O gs / menus an d SQL databases, 


ment for simple manage- 


se silo * orward including DB2, Informix, Oracle, and 

4 Develop screens for Gutor  2©2L Server; provides generation of 
LO; e 

character-based applications. graphic screens and menus from 





©1993 Popkin Software & Systems Incorporated. The System Architect logo is a trademark of Popkin Software & Systems, Inc. All other brand names and products are trademarks or registered trademarks of their respective holders. Specifications subject to change at the sole discretion of the company. 





















-DLG and .MNU files; ensures new SQL database applica- 
tions are built with the proper design integrity. 

SA Screen Painter: Allows you to create GUI or charac- 
ter screens as well as to edit screens generated automatically 
from your SA Data Dictionary or captured from existing 
Windows applications; generates MS Windows dialogs, 
COBOL screen sections and associated data structures. 

SA Schema Generator: Translates entity models from 
the encyclopedia into schema for DB2, Oracle, Ingres, SQL 
Server, Rdb, PROGRESS, 
Paradox, SQL Base, AS400 
(SQL & DDS), Interbase, 
OS/2 DBMS, dBASE III, 
XDB, SYBASE, and 
Informix. Generates Win- 
dows DLGs, and C type 


data definitions or 


COBOL data structures. 








4 Paint GUI screens. 
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owerful CASE tool 
esigned ONC?” mcm. 


SA Object Oriented Analysis & Design 
(OOA/OOD): Supports Booch °91 and 
Coad/Yourdon. 

SA Network Version: Diagram and data dic- 
tionary record locking allows multiple project 
members to work concurrently on the same pro- 
ject while continuing to share the encyclopedia. 


Built for Engineers. 


Unlike many tools, System Architect is a CASE 
tool that is being used. And used effectively. But 
then, that’s what it was designed for. In addition to 
its open architecture and the power to handle even 
the most complex applications, SA has a wide 
range of other advantageous features: automated 
documentation; an extensible data dictionary; nor- 
malization, rules and balancing; requirements 
traceability; import/export capability; custom 


reporting; auto leveling; and CRUD Matrices. 


The Bottom Line. 
System Architect is a CASE tool that works. Our 


best customers are the ones who have tried other 
products before buying ours. They continue to tell 
us that there is no easier-to-use, more powerful, more flexi- 


ble, more affordable CASE tool anywhere. 


Call us toll-free today at 


800-REAL-CASE, x101. 


For real-world CASE solutions at an afford- 
able price, call us today at our toll-free num- 
ber or fax us at 212-571-3436. And find 
out how you can qualify for your free 30- 
day evaluation copy. 


SYSTEM ARCHITECT 


Popkin Software & Systems, Inc., 11 Park Place, N. Y., NY 10007 


Worldwide Sales: Italy 39-49-8700366; Denmark 45-45-823200; 
Switzerland 41-61-6922666; Germany 49-615 1-82077; 
Sweden 46-8-626-8100; Benelux 31-3406-65530; 
England 44-926-881186; Australia 61-02-346499; 
Elsewhere 212-571-3434 
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FEATURES 


THE HISTORY OF PROGRAMMING LANGUAGES 18 
by K.N. King 


It's been 15 years since the first History of Programming Languages conference brought 
together the inventors of Fortran, Basic, Lisp, Cobol, APL, and the like. In this special 
report, we cover this year’s History of Programming Languages II conference which 
assembled the designers of C, C++, Pascal, Smalltalk, Ada, and other languages. 


C/C++ STANDARDIZATION: AN UPDATE 26 
by Rex Jaeschke 

Rex, who’s an active member of the Standard C, ISO C, and numerical C extensions 

groups, brings you up to date on C and C++ standardization processes. 


STRATEGIES FOR BETTER LINKED LISTS 32 
by Garyl Hester 

Linked lists are fundamental tools used by any application that deals with variable types 

and data. Garyl discusses linked-list theory and presents a generic linked-list toolkit 

written in C. 


C++ TEMPLATES Aa 
by Pete Becker 

One of the benefits of C++ templates is they make it easier for you to write custom 

tools. From parameter types to instantiation, Pete turns templates inside-out, while Doug 

Reilly builds a C++ virtual-array template class to show how templates can be used. 


CALLING C FUNCTIONS WITH VARIABLY DIMENSIONED ARRAYS 52 
by John W. Ross 

When it comes to passing multidimensional arrays, C could learn a few tricks from 

Fortran. John presents a programming technique whereby you can pass these arrays to 

a C function. 


INDEXING IMAGE DATABASES 60 
by Art Sulger 

Document-imaging systems must store and retrieve large amounts of unstructured data. 

The algorithm Art presents here, implemented as a C++ class, is the basis of an indexing 

system that accomodates many different image-file formats. 


EMBEDDED SYSTEMS 


PROGRAMMING THE MOTOROLA 68332 66 
by Jack J. Woebr 

Jack examines Motorola’s 68332 time-processing unit (TPU) and queued serial module 

(QSM), presenting Forth code for programming QSM registers. 


NETWORKED SYSTEMS 


NETWORK ACCESS TO CD-ROMS M2 
by John H. McCoy and Wubsiung Lu 

To provide access to CD-ROMs across a NetBIOS-based network, John and Wuhsiung 

implemented this client/server architecture which supports file redirection and ancillary 

MSCDEX functions. 
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EXAMINING ROOM 


INTEGRATING DESKTOP MAPPING WITH GEOGRAPHIC DATA 84 
by Peter D. Varhol 

Mapping engines give you tools for combining mapping functions with traditional 
database or spreadsheet data. Peter shows how TerraView, a C library for displaying and 
manipulating maps, teams up with the Microsoft Access database system. 


PROGRAMMER’S WORKBENCH 


A QUICK PORT WITH QUICKWIN 92 
by Al Williams 

Al ports Turtle, his DOS-based turtle-graphics program, to Windows 3 using QuickWin, 

the Visual C++ library designed for DOS-to-Windows ports. 


COLUMNS 


PROGRAMMING PARADIGMS 117 
r] by Michael Swaine 

What the heck is going on at Apple? Between (what he refers to as) MacOpen, 

MacDOS, Macnix, MacRISC, and MacNeXT, our MacMichael wonders how far Apple can 

push the cross-platform envelope. 


C PROGRAMMING 123 
a by Al Stevens 

There’s more to building a custom PC keyboard than parts and cables—you also have 

to know how the keys interact with the electronics. Al presents software that reads and 

displays I/O ports, gets keyboard scan codes for the selected keys, and converts push- 

buttons to keystrokes. 


ALGORITHM ALLEY 129 
by Tom Swan 

To understand Windows bitmap compression, Tom writes a set of test programs that 

compress and decompress pixel values stored in plain text files. He then describes the 

algorithms and presents two C++ programs in the test suite. 


UNDOCUMENTED CORNER 133 
edited by Andrew Schulman 

Windows .RES files, generated by the Windows resource compiler, contain the binary 

images of Windows menus and dialogs prior to their inclusion in executable files. Alex 

Fedorov and Dmitry Rogatkin unravel the .RES file format. 


PROGRAMMER’S BOOKSHELF 143 


by Ray Duncan 
Ray wraps up his multipart review of Internet books and provides a comprehensive list 
of Internet-focused books. 
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EDITORIAL 8 
by Jonathan Erickson 


LETTERS 10 
by you 


SWAINE’S FLAMES 160 
by Michael Swaine 


PROGRAMMER’S 
SERVICES 


OF INTEREST 154 


SOURCE CODE 
AVAILABILITY 


AS a service to our readers, all source 
code is available on a single disk and 
online. To order the disk, send $14.95 
(California residents add sales tax) to 

Dr. Dobb’s Journal, 411 Borel Ave., San 
Mateo, CA 94402, or call 1-415-358-9500, 
ext. 240. Specify issue number and disk 
format. Code is also available through the 
DDJ Forum on CompuServe (type GO 
DDJ), via anonymous FTP from site 
ftp.mv.com (192.80.84.1) in the /pub/ddj 
directory, and through M&T Online, a free 
service accessible via direct dial at 415- 
358-8857 (1200/2400-8-N-1). 


NEXT MONTH 


It’s all in the numbers in our September 
issue where we will examine numerics 
and numerical programming. 





Master Windows’ 
with help 
from master minds. 
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SYBEX 


Say good-bye to lengthy, unintelligible manuals. Turn instead 


to master minds to help you produce polished Windows programs. 
The master minds from SYBEX. 


You can count on SYBEX to bring you books written by respected experts who 
have a wealth of programming experience—authors who understand the real- 
world applications programmers like you must develop. Each book brings you 
unique insights and practical examples you can use immediately to improve your 
programming skills. 





PROGRAMMER’S INTRODUCTION TO WINDOWS 3.1 
For beginning and intermediate C programmers © Brian Myers & Chris Doner 


= Step-by-step tutorials explain essential Windows programming techniques ™ Contains 
several complete programs illustrating real-world Windows applications = Written by 
professional developers of commercial Windows software = Comes with 950K of 
Source code on a FREE 5'/4’ disk 


ADVANCED TOOLS FOR WINDOWS DEVELOPERS 
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The Worlds Best Selling 
UNIX Clone Just Got Better. 


Now with full 32-bit 
implementation! 

If you want to ignite your 32-bit hard- 
ware with the multi-user, multi-tasking 
power of UNIX, Coherent 4.0 has arrived. 
And if you’re operating or selling 
small business network systems 
with dozens of users, that's really 
good news. Because Coherent 
4.0 is what you want in 
UNIX at a price that's hard 
to believe. 


Run UNIX 

applications today! 
Coherent is now bin- 

ary compatible with UNIX. Most 

UNIX PC applications port with a simple 

recompile and many now run right 

out of the box. The list is growing 


everyday, So Call for details. 
@ UUCP capabilities that connect you 


Yes, It’s For Real! 

How can it be? First of all, O erenl] 
Coherent was independently 
developed by the Mark Williams e to ghana yavientets ae 
Company, so you don’t pay for a | €, ea = bil ae 
UNIX licensing fees. You don’t pay ] q er ee os ei C sts - 
any mark-up or reseller costs & @ documented in Coherents highly 


six disk installation is a breeze 
compared to their 25. You'll also 
learn it faster and increase over- 
all performance. All because 
Coherent is smaller, faster... 

and better. 


Small, But So Complete. 
Make no mistake, Coherent 
is a wholly professional develop- 
ment system. You get a complete 

















C compiler, assembler and over 200 UNIX 
commands including full sets of functions 
for development, administration, 
‘MW maintenance and text processing. 
Coherent also comes with 








either. Coherent is only sold directly to you. prac 1200 page manual. 
Experienced, Supported, 
COHERENT uNIv336 | Guaranteed. 
Version 4.0 Version 3.2V2 Mark Williams Company has been 
developing professional programming 
doa ie = tools since 1976. Our commitment to 
No. of Disks : 
sik a7sx | Our products and users is unsurpassed. 
In fact, over 40,000 copies of foe Users applaud our popular BBS and the 
Coherent have already been sold. And, eee 40min. 34hours | widely acclaimed telephone support 
like the ones we quote here, virtually Suggested Disk Space 10meg 60 meg | they get free from Coherent developers. 
every critic who's reviewed Coherent has __| Min. MemoryRequired Imeg 2-4 meg Still, we’re not asking you to take a 
raved about it. Performance* 85.7 31.3 | chance on Coherent. We’ve made it fool- 
i $99.95 $2590 | proof to see for yourself—with a 60-day 
So Much Less dn 
Yet So Much More *Byte C Compiler Benchmark: Compiles per money-back, no hassles guarantee. So 
A . IX Coh minute on 25 MHZ 486. pick up that phone and order Coherent 
s a virtual clone of UNIX, Coherent now. And the best way to UNIX will be 
embraces the original UNIX philosophy: on its way to you! 


Small is beautiful. Small price, yes. But there's more, much 


more, to Coherent than its amazing price. S00-MA RK WMS 


Requiring only 10 megabytes of disk space, Coherent (800-627-5967 or 708-291-6700, FAX: 708-291-6750) 
can reside with DOS. So you can keep all your DOS 60-DAY MONEY BACK GUARANTEE! 


applications and move up to Coherent. And it runs with 
as little as 1 MB of memory versus 4 MB for other UNIX 


versions. fim 
The World's Only Plug And Play UNIX Clone. 


You'll have Coherent up and running with a fraction of 
the time and effort it takes for other UNIX versions. Our 


Mark Williams Company 
60 Revere Drive, Northbrook, IL 60062 
Coherent is a trademark of Mark Williams Company. UNIX is a trademark of USL. 





Distributors: Australia + 07-266-2270, Brazil + 011-883-2299, Czech. + 06-32-62877, France + 1-4741-4519, 1-4672-8074, Germany + 0511-53-7295, Greece + (01) 222-351], 
Holland + 023-386-599, Hungary + 153-0988, Malaysia + 03-756-4477, Venezuela/Caribbean + 1-809-723-5000, Sweden + 06-60-19290, UK + (0) 81-541-5466 











P C can (| th e 3R § S iting here sweltering in the dog days of summer, no one really wants to be thinking about 
reading, ‘riting, and ‘rithmetic. Still, it won't be long before school bells are ringing, locker 
doors slamming, and, if the PC industry has its way, disk drives whirring. 

Education is fad happy (although cynics might contend “fad plagued”). From whole-language 
strategies to school vouchers, another new liniment for educational aches and pains is around the 
corner. Computers in the classroom is one such teacher's pet. Computers, say the experts, will 
make teachers more effective, students more attentive, and learning more meaningful. 

The problems that fads are supposed to solve range from high truancy rates to low test scores. 
According to the results of the International Assessment of Education Progress exams given to 
students in 15 nations, U.S. students ranked 7th in science and 14th in math. At the same time, U.S. 
SAT scores show little improvement, with the verbal scores dipping from 426 to 423 while math 
scores improved slightly from 467 to 476. PCs, say the PC industry, will improve this. 

Schools have long been among the crown jewels for computer companies. The software vendor 
who cracks the halls of academia with a killer app will move to the front of the class, finance-wise. 
Book publishers have known this for years—that’s why they wine-and-dine textbook-selection 
committees, particularly in California and Texas whose leads other states follow. 

Education is big business, and technology vendors—from PC makers like Apple and IBM to 
Chris Whittle’s Channel One in-school TV commercials—want a piece of it. The U.S. alone spends 
more than $215 billion a year to educate over 46 million students in pre-university schools. Even a 
small piece of a multibillion dollar market is worth going for, and marketing efforts are on the 
upswing. (At a recent education technology conference, one investment banker was quoted as 
saying that “educational multimedia will be the investment opportunity of the ’90s.”) 

PC companies make their pitch to schools in a variety of ways, including studies like the 
Software Publishers Association’s “Report on the Effectiveness of Technology in Schools 1990-1992” 
conducted by Interactive Educational Systems Design, an educational-technology consulting firm. It 
comes as no surprise that the report, ultimately funded by software companies, concludes that 
technology has a positive effect on student achievement, self-concept, and attitudes. 

However, the U.S. arguably is ahead of other countries in implementing technology in schools 
(about half the states are on the road to requiring computers in the classroom), even while SAT 
scores are down from 20 years ago with no improvement in reading and writing skills. None of the 
other countries in the International Assessment study rely on computers to the extent the U.S. does. 

So how do we go about fixing education? 

Lewis Perelman, author of School’s Out: Hyperlearning, the New Technology, and the End of 
Education, says, “Education cannot be reformed, it needs to be replaced.” He adds that “schools 
don’t need to be housed in buildings at all—most can be accessed through a portable, personal 
telecomputer terminal,” explaining that through telelearning “schools will be transformed from a 
centralized architectural and bureaucratic structure to a dispersed information and service channel.” 

Less extreme are research projects like Vivarium, which has been exploring technology-based 
solutions for several years. Vivarium, sponsored by Alan Kay and Apple Computer, studies 
computers as “amplifiers for learning” at the Open School in Los Angeles. According to Kay, 
Vivarium seeks “to better understand the value computers might have as supporting media.” 

Ultimately, however, many arguments for technology-based solutions to education woes don't 
wash. Hardware and software are often too expensive and ill-designed, and teachers too busy and 
inadequately trained to use them effectively. Technology can help in many situations, but it’s not 
the sole answer as Perelman and others might profess. 

PCs do have a place in schools but we need to look at where computers have proven 
successful, then model education use accordingly. In business, for instance, PCs have clearly made 
a difference in record keeping and communication. Spreadsheets and databases for calculating and 
recording grades and maintaining student records can free up teacher time, enabling more teacher- 
student interaction. Networking PCs with administrative offices would make even more time 
available. Adding communication capabilities so that teachers can communicate with parents is 
another step. Simulation, which has proven successful in business and engineering, lends itself to 
student exploration in science and math. (The Vivarium project has had great success with 
ecological simulations.) 

Technology is not the solution to education’s problems. Instead, technology is, as Alan Kay says, 
“supporting media” that makes it possible for teachers to more closely interact with students and 
parents and more closely focus on individual needs—elements that even Perelman admits are critical. 


Poulin 


Jonathan Erickson 
editor-in-chief 
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Visual Development 


The Phase3 visual development environment 
provides a comprehensive suite of tools for 
screen creation. All standard Windows 
screen objects — push buttons, radio buttons, 
dialog boxes, etc. — are selectable from icon 
bars and are dynamically placed and sized 
on the screen as appropriate for the 
application. Standard Windows APIs are 
available from list boxes and are supported 
with on-line documentation. 


















Phase3 Database 


Phase3 includes a relationally complete 
database supplied as a Windows DLL. The 
database supports complex data relation- 
ships and access and data manipulation by 
any language through a comprehensive 
suite of supplied database routines. 
Database integrity is enhanced with 
rollback recovery and transaction control. 
The Phase3 data dictionary simplifies data 
model definition and maintenance. 


Query and Reporting 


The Report Writer includes standard 
features like flexible headers, footers, free 
text, calculated fields, sort group sections 
and breaks, and subtotals. Reports can also 
include bitmaps of drawings and photo- 
graphic images. Queries are executed with 
the Database Browser which also allows 
data entry and manipulation. Railway 
diagrams assist in query creation, prompt- 
ing the user for appropriate selections and 
eliminating syntactical errors. 

















Will Make You a Winner in 
Windows Application Development 
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Lower CASE, E-R Modeling 


Phase3 automates logical data model design 
with Entity-Relationship modeling. After a 
user describes entity relationships graphi- 
cally and enters field descriptions, Phase3 
generates the physical database based on an 
analysis of the entity relationships. Phase3 
automatically includes foreign keys in 
appropriate tables and restructures the 
database as requirements change. Phase3 
suggests appropriate referential integrity 
constraints to be enforced at runtime. 


seers 
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Hierarchy Chart 


Phase3 maintains a graphical map of an entire 
application. The Hierarchy Chart includes all 
windows, dialogs, reports, and code routines. 
To access the underlying C or Pascal source 
code, simply point-and-click on any node. 
Phase3 generated source is easily accessed 
and extended with user written routines. User 
code is preserved even if an application is 
regenerated. The Hierarchy Chart and E-R 
Diagram provide instant core documentation 
for an application. 
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Help Generator 


The Phase3 Help Generator allows the easy 
creation of a complete Windows application 
help subsystem including context sensitive 
on-line help. The Help Generator includes its 
own text editor that gives complete control 
over the content, appearance, and branching 
logic through highlighted trigger text. Phase3 
generates a Windows compatible file with an 
‘HLP” extension that is then accessible 
from within the Phase3 created application. 
No other external tools are required. 


























Windows is a trademark of Microsoft Corporation. Turbo Pascal for Windows and Borland Pascal 7.0 are trademarks of Borland International, Inc. All 
other trademarks or service marks are recognized as the property of their respective owners. 





Phase3 is the quickest and 
easiest way to develop a 
winning Windows applica- 
tion. Phase3 has everything 
you need to design, develop, 
deliver, and maintain a 
complex application. 





Whether you are developing 

for resale or internal use, Phase3 is your 
best choice. Phase3 applications are roy- 
alty free and do not require any run-time 
engine. And Phase3 generates high perfor- 
mance applications with ANSI standard C, 
Turbo Pascal for Windows, and Borland 
Pascal. The choice is yours. 





Or Call for Free Demo Disk 
USA: Fax (805) 641-9083 
Australia: Fax (06) 285-4169 


' 60 Day Money-Back Guarantee 
Order Phase? at the special introduc- 
~ tory price of $395 [normally $795] 
before July 31. If you’re unhappy for 
any reason return the product in mar- 
ketable condition within 60 days for a 
- complete refund. 
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Windows Instance Return 

Dear DDJ, 

Just about the most common program- 
ming task required for each application 
I write for Windows is located at the be- 
ginning of WinMain, namely, code to 
ensure that, at most, one instance of the 
application can exist. All this code has 
to do is return to the previous instance, 
if any. Sounds simple, right? Well, there’s 
no Windows function to do it! Not only 
that, but the existing published exam- 
ples I’ve seen fail in a number of sim- 
ple situations. See Example 1 for some 
generalized code that you can plug right 


into your applications to accomplish this 
common task. This code has been test- 
ed in several applications. 

David Spector 

Waltham, Massachusetts 


Copyright Questions 

Dear DDJ, 

Having owned three IBM-compatible 
computers since 1982 and having used 
several such computers at work, I’m 
concerned about the issues raised in 
your January “Editorial.” In this ten-year 
period, I’ve probably spent more dol- 
lars on software than on hardware. I 
have also upgraded software numerous 
times and changed to new products 
when old products failed to stay com- 
petitive or when their update costs were 
out of line with those of their competi- 
tors. I also have made a conscientious 
effort to regularly backup my systems 
at home and at work using both flop- 
py- and tape-based techniques. Com- 
bining this experience with your edito- 
rial has prompted several concerns. 
Therefore, I would be interested in an 
article addressing the following: 


Ignorance of the law. Publishing 
a copy of the law and an interpreta- 


/* find_prev_wnd(): Find the main window of the previous 
* instance by searching all top-level windows 


* / 
HWND 
FARPROC 


prev_wnd; 
find_prev_wndi; 


BOOL CALLBACK _export find_prev_wnd(HWND wnd, LPARAM 1Param) 
{ 


/* Look for a top-level window having the same instance*/ 


if (!GetParent (wnd) 


&& GetWindowWord(wnd, GWW_HINSTANCE)== (HINSTANCE) 1Param) 


{ 
prev_wnd = wnd; 


return FALSE; /* Stop enumerating */ 


return TRUE; /* Continue enumerating */ 


} 


/* Main application function */ 
int pascal 


WinMain(HINSTANCE hInst, HINSTANCE hPrevInst, LPSTR pCmdLine, int Show) 
{ 


/* If there is a previous task instance, return to it */ 


if (hPreviInst) 
{ 


find_prev_wndi = 


MakeProcInstance((FARPROC)find_prev_wnd, instance) ; 
EnumWindows(find_prev_wndi, hPrevInst) ; 
FreeProcInstance(find_prev_wndi) ; 

/* Window not found error */ 


if (!prev_wnd) 
return @; 


/* Fail silently */ 


/* Return to the last active popup window, if any, 
* of the previous instance 


*/ 


prev_wnd = GetLastActivePopup (prev_wnd) ; 

/* if the existing window is minimized, restore it */ 
ShowWindow(prev_wnd, SW _SHOWNORMAL) ; 
SetActiveWindow(prev_wnd) ; 


return @; 


} 


} /* werent) */ 


Example 1 
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tion of it in plain English would be 
most helpful. Along with this inter- 
pretation, the impact of the law on 
some typical examples would be most 
helpful. Only with this type of assis- 
tance can the user community under- 
stand how the law relates to their use 
of computer software. 

Creditability of vendor records. 
During this ten-year period I have made 
an effort to register all of my software. 
Unfortunately, when I moved recently, 
I found out that many vendors do not 
make a very strong effort to track their 
users. In many cases their records were 
incomplete or non-existent, or they had 
mixed up registrations for work and per- 
sonal copies. In one case, the vendor 
had no way to track copies owned at 
both work and home by the same in- 
dividual. Their response in many cases 
was to send in the registration card 
(which had been sent to them years be- 
fore). Therefore, how can the user com- 
munity be held responsible for proof of 
license when vendors are not diligent 
in their record keeping? 

Number of copies made. Your arti- 
cle states that if more than two copies 
are made for personal use, penalties can 
be imposed. Does this cover copies con- 
tained in system backups? If so, proba- 
bly every user of backup software could 
be sent to jail. Most long-term users have 
learned that incremental backups are 
fine over the short term, but that full 
backups are required periodically if sys- 
tem restoration is to be feasible in any 
sort of reasonable manner. In ten years 
I have probably accumulated numerous 
copies of key software on my floppy 
and tape backups. 

The other aspect of this question is, 
what about previous versions of the soft- 
ware—do they count as additional 
copies? In many cases as software has 
changed over the years the new ver- 
sions lack direct compatibility with data 
created using previous versions. There- 
fore, to provide reliable access to this 
data, all versions of the software must 
be retained. 

What if the software license allows you 
to make more than one copy, do the 
numbers stated in the law still apply? 

Purpose of backup copies. We 
backup software to ensure that if some- 
thing happens to the original diskettes, 
we can still use the software. What is 
our position if the originals are lost or 
destroyed? Having a legitimate copy of 
software without the original disks may 
place the user in a difficult situation. 
Also, in such a situation, can the user 
then legally make an additional copy? 
Further, does the working copy of the 
software on the hard disk count as one 
of the two backup copies? 
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® Here’s a C Set offer with lots 
les of pluses. From IBM Program- 
ming Systems. Because for only 
$149, you can upgrade from 
Work Set/2 or C Set/2 to the new 


C Set++™" the most complete object- 
oriented application package you can 


buy for OS/2° 


Its 32-bit C/C++ compiler 
lets you unleash all the power 
of OS/2 — giving you industrial 
strength code for your mission 








critical applications. 
It has an extraordinary code optimizer with a full 
set of options. Even a switch to optimize for the new 
Pentium™ processor. Plus a full set of class libraries, 
including application frame- 
works for PM, container classes 
and classes for multitasking, 


NIST validated 
streams and more. Seliver-lee ks 


C Set ++ Technical Features 





features. Such as an interactive source level debugger. Ls 
Inter-module 
diagrams of the analysis. 


Plus, there’s 
dpe alle: a full complement SO 9899:1990 
of other helpful — 
And the unique Execution Trace Analyzer traces the 
execution of a program, then graphically displays Optimization 
Plus, you get Workframe/2™ a language-independent 
tool that lets you customize your own environment. : . 





Fy 


cee eS eer 





To order your upgrade at the low price of only $149, 
contact your nearest dealer or call 
1-800-342-6672 (USA) or 
1-800-465-7999 ext. 461 (Canada). 
But hurry. This offer expires August 31, 1993. 


IBM and OS/2 are registered trademarks and C Set++ and Workframe/2 are trademarks of International Business Machines Corporation. 
Pentium is a trademark of Intel Corporation. Windows is a trademark of Microsoft Corp. © 1993 IBM Corp. 
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(continued from page 10) 

Burden of proof. Your editorial im- 
plies that the powers that be must first 
establish reasonable proof that you have 
violated the law to enter your office or 
house. Could they use the fact that you 
own an option board or Fastback as an 
indication of generic guilt and search 
for any duplication, or must they specif- 
ically state that they are looking for du- 
plicate copies of Wordperfect? If they 
must be specific, what happens if they 
find other copied software during their 
search? If the first case is true, then 
maybe the industry should track the sale 
of all companies selling backup soft- 
ware more closely. 


Out-of-print software. Several of the 
programs I have used over the last ten 
years have ceased to be available. Can 
I make copies of these programs to al- 
low others to access the old data creat- 
ed with them? 

Define availability for use. If you 
have a computer at home and one at 
work, can you use one copy of a soft- 
ware package in both locations under 
any of the following conditions? 


1. You delete and reinstall the package 
with each use. 

2. You delete and reinstall only the main 
.exe file with each use. 

3. Your computers are password pro- 


TURN TO TURNING POINT 


For a very simple reason - We under- 
stand the business of software product 
development and we’ve been doing it 
successfully since 1983. 

Our approach to project management 
insures proper controls, scheduling and 
budgeting. With a full time Quality 
Assurance and experienced Software 
Engineering staff, we have the technical 
excellence and proven track record to 
get your product done right. Plus, our 
experience in Macintosh®, 
MS-Windows® and DOS cross platform 
development is unparalleled. 

Turning Point Software, the one to 
turn to for software product development 


at its best. 


Call or write for a free portfolio. 


TPS Turning Point 


One Gateway Center 


Newton, Massachusetts 02158 


617-332-0202 
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tected or locked and only you have 
the means of access. 

4. Your computers are used only by you 
at both locations, but there is no 
physical or software control that pre- 
vents others from using them. For in- 
stance, no one at home knows how 
to use the computer and your office 
is locked when you are not at work 
and the computer is assigned for your 
use only. 


Existing copyright procedures. 
How does the new law relate to the 
ability of individuals to record video and 
audio works for personal use? 

I hope that you find these issues use- 
ful in the development of an article ad- 
dressing the critical issues. As for me, I 
wonder why a nation with an increas- 
ingly permissive society supports the 
Gestapo-like tactics of the SPA. Because 
of my lack of understanding regarding 
the full implementation of the new and 
or existing laws and SPA’s use of fear 
to motivate software users, I must re- 
quest that you not print my name in 
your magazine. 


OS Resource Management: Another Country 

Heard From 

Dear DD, 
I take issue with Andrew D. Todd’s as- 
sertion that it is the role of the operat- 
ing-system developer (OSD) to manage 
computer resources (“Letters,” DDJ, 
February 1993). It is the role of the OSD 
to provide computer resources. Man- 
aging those resources should be the role 
of the application-program developer 
(APD), which implies that the APD be 
given the opportunity to manage them. 
When an OSD provides resources that 
it uses routinely in its own software 
products, but refuses to make available 
to the programming community at large, 
that is management of computer re- 
sources of a particularly invidious sort. 
Furthermore, the whole point of Un- 
documented DOS (and, I assume, Un- 
documented Windows) is not that Mi- 
crosoft should put more into DOS in 
order to reduce the workloads of APDs, 
but that DOS already has more in it than 
Microsoft is willing to divulge. The work 
of the authors of the Undocumented 
books, and the thousands of others who 
mine for hidden nuggets in the operat- 
ing systems we've bought into, is based 
on the premise that everyone who owns 
a stake in the claim should start digging 
with the same-sized shovel, and have 
an equal chance at striking a rich vein. 
Microsoft’s claim that it doesn’t doc- 
ument some features because it would 
then be committed to supporting them 
in the future rings a bit hollow. Many 
(continued on page 17) 
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WATCOM™ SQL for Windows 


by WATCOM 


WATCOM™ SQL for Windows is a complete 
client/server DBMS including a standalone sin- 
gle-user SQL database server. WATCOM SQL for 
Windows allows you to develop and deploy single- 
user standalone applications, and to develop 
applications for use within the WATCOM SQL 
Network Server Edition. WATCOM SQL for 
Windows includes support for the Microsoft Open 
Database Connectivity (ODBC) standard for database applications. 


List: $395 Ours: $299 
FAXcetera # 1683-0013 





ProBas 5.5 
by TeraTech 


ProBas has 938 routines to make your pro- 
grams faster and more professional. Includes 
routines for: Virtual screens, a complete GUI, 
file compression, extended/EMS support, 
improved file [/O, mouse, windowing, sorts, 
string documentation. No royalties. Requires 
QuickBasic, Basic PDS 7, or VB for DOS. 
Hard disk required. 3-5 MBS. 


List: $195 Ours: $168 
FAXcetera # 2994-0002 





Multimedia Toolbook 
by Asymetrix 


Complete Multimedia Authoring. 

Create your own multimedia applications for 
MS Windows. Simple interface and set of ready- 
to-use multimedia objects make it the fastest 
and easiest way to develop multimedia apps. 
This award-winning tool provides a complete 
package versatile enough to develop new applications or put a new face 
on existing ones, with no runtime fee. 


List: $695 Ours: $529 
FAXcetera # 2776-0005 





MATLAB? 4.0 for 386 Windows 
by MathWorks 


A high-performance, interactive numeric computa- 
tion and visualization environment that combines 
hundreds of advanced math & graphics functions 
with an easy-to-use and flexible high-level lan- 
guage. The open system architecture enables 
users to view the pre-packaged functions, cus- 
tomize them as needed, or add new functions. MATLAB toolboxes are 
available to extend the power by providing leading-edge algorithms and 
functions developed by renowned experts for specific applications. For 
technical information call 508-653-1415; to order call 800-445-7899. 


List: $1695 Ours: CALL 
FAXcetera# 1695-0002 


























ED for Windows $169 
EDT+ $199 
Gauss-386i CALL 
IBM OS/2 Upgrade $99 
Logic Gem $83 
Micro-Scope $399 
MS Visual C++ Standard $137 
Professional $289 
Version Upgrade $129 
Comp. Upgrade $189 
Multi-Edit $79 
OPTLib for DOS/Win/OS/2 $189 
-OPTLink for Windows $315 
ProBas 5.5 $149 
Rescue $50 
-RTLink Plus $399 
SQA: Manager-Win $799 
SQA: Replay OS/2 $50 
WATCOM C/C++? v9.5 CALL 


‘object oriented development system for 
soft Windows. Allegro CL/PC is based 


gramming language, and includes 
OS, the Common Lisp Object System. 
sro CL/PC offer advanced development 


ndly environment. Allegro CL/PC 
intime generator with royalty-free 
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GAP Hics 
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act. Features 
Vindows API 
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Lahey F77L - 
FORTRAN Compiler 
by Lahey 


Version 5.01 includes FORTRAN 90 features: 
ALLOCATABLE Arrays, CASE Constructs, 
Cycle and Exit, Construct Names, and many 
other new features. Package includes Editor, 
Make Utility, Profiler, Debugger, SLR Linker, 
Opus Make, Video Graphics, and Excellent 
Diagnostics. 386/486 users have the option 
of generating 32-bit instructions. 


List: $295 Ours: $259 
FAX cetera # 1476-0001 








WindowsMAKER 
Professional 5.0 es, 
by Blue Sky Software On, 


Next generation of the most powerful C/C++ Code 
Generator and Prototyper for Windows 3.1, NT & 
Win32s. The fastest way to create full-featured 
Windows apps. This product stands out, does 
everything—even a toolbar can be created with 1 
click! Test run your design, make changes interac- 
tively, generate code for multiple platforms—ANSI C, MFC, OWL, etc.; widest 
compiler support in industry. TrueCode technology—user code is 100% pre- 
served. Highly recommended! 

List: $995 Ours: $839 

FAXcetera # 2602-0003 





CA-dBFast™ for Windows 2.0 
by Computer Associates 


The complete standalone dBASE/Xbase develop- 
ment language for MS Windows. Create fast, 
powerful, easy-to-use graphical applications with 
over 200 extensions to the dBASE III PLUS lan- 
guage. It also includes an interactive editor, 
compiler, and linker. Challenge your creativity 
and imagination! Design multiple windows, pull- 
down menus, check boxes, list boxes, radio buttons, bit-map pictures, 
and more! 


List: CALL Ours: CALL 
FAXcetera # 1004-0003 





Dan Bricklin’s Demo II 
by Lifeboat Software 


Experience for yourself why 30,000 peo- 
ple have made Demo II 3.0 the leading 
tool for producing program proto- 
types, demonstrations, and tutorials. 
Demonstrate commercial software to 
potential customers without shipping live software. Produce effective 
tutorials that interactively teach product. Create computer based train- 
ing for a fraction of the cost of dedicated CBT authoring software. 


List: $249 Ours: $215 
FAXcetera # 0233-0003 











Tices! 


OS/2 2.1 
by IBM 


OS/2 v2.1 lets you take advantage of the award- 
winning features found in v2.0 and increase your 
productivity with new enhancements. Includes 
support for MS Windows v3.1 applications includ- 
ing enhanced mode and full 32-bit graphics 
engine. Adobe and TrueType Font support gives 
you the best of both worlds. WIN-OS/2 setup icon 























List: $249 Ours: $139 
$199 Ours: S$ 89 







PRODUCT OF THE MONTH 
Microsoft Visual Basic 3.0 
19 )'ga\VJ0(e) wey-fe) hen @reyusleyucta level 


New Version 3.0! Now with built in data access, 

OLE 2.0 and more! Program for Windows the 

fast, easy way with MS Visual Basic for Windows, 

Standard Edition. A visual] development enviro- 

ment, flexible programming language, and now 

access to your data make this the most productive 
way to go from initial idea to impressive application. 


Standard List: $199 Ours: $139 
Version Upg. List: S 49 Ours: $ 45 
Comp. Upg. List: S$ 99 Ours: $ 95 
Prof. Edit. List: $395 Ours: $217 
FAX cetera# 1269-0033 
























‘he ee released CA-Clipper version 
is being offered to Xbase language 
*t owners at the low retail price of 
). This competitive upgrade is avail- 

le for a short term only! What a great 
opportunity to get the power of CA-Clipper, 
at a super price! And now when you buy, 







































CD-ROM MultiSpin™ 


MS Visual C++ is the next generation 
successor to the popular Microsoft C/C++ 
development system. The NEC CD-ROM 
ultiSpin is a portable CD-ROM Drive 
















Visual C++ Prof. w/CD-ROM 
List: $1033 Ours: $649 
grade w/CD-ROM 





= etitive Upgrade w/CD-ROM 
List: $837 Ours: $589 















M e staWare High C/C++ 
| by MetaWare, Inc. 


_NEW RELEASE! High C/C++ version 3.1, 
| MetaWare’s 32—bit compiler is shipping. 
Includes a 32-bit source-level debugger, and 
a 32-bit Application Developers Kit for 
Windows. The “Incremental Strengths” fea- 
ture enables gradual migration from C to C++ 
one block at a time. High C/C++ provides 
optional ANSI conformance, eight levels of 
global optimization and a full implementation of C++ templates. Ir der the Windows environment. 


List: $795 Ours: $669 ) Ours: $359 
_ FAXcetera # 1590-0008 A 3 - 1987-0005 


Met A y PocketSoft, Inc. 


/MData for Windows is a DLL that manages up 

128 MB of dynamic data. Eliminates annoy- 
ng slowdowns commonly seen in 386 
Enhanced Mode when programs use large 
amounts of dynamic data, and eliminates out- 
yf memory problems in Standard Mode. 
Provides superior run-time performance and 
sures that your program is a good citizen 
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| BASIC Network Library 
_ for Windows v2.0 Network C Library 
_ by Microsoft Corporation by Automation Software 





Consultants, Inc. 


The most comprehensive libraries available for 
NetWare software development, supporting all 
versions of advanced NetWare including 3.11. 
Over 450 C functions and 300 BASIC func- 
—— tions. Include any features from the NetWare 
mat .d line utilities and menu utilities in your C or BASIC program. 
ir hassles. C library source code available. 






_ MS Test 2.0 is an automated testing tool designed 
| to help developers create high quality Windows 
| applications. You can experience the following ben- 
| efits of automated testing: consistency, accuracy 
| and thoroughness. Perform the thorough testing 
| that complex applications require, with minimal impact on your sched- 
| ule. Provides a user interface editor to design custom dialogs for test 
_ suites. A user can enter parameters so that the same test case can be 



























run a number of times with different input. List: $265 Ours: $229 
List: $495 Ours: $399 | List: $295 Ours: $259 
1812-0001 _F& # 1004-9201 
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Multi-Edit Professional 
by American Cybernetics 


A richly featured, easy-to-use program- 
mer’s text editor. Multi-Edit’s flexibility 
and sheer power combine to provide you 
with ein oe , Features 





WATCOM™ C/C++” v9.5 
















/C++” is a professional, multi-platform 
‘and C++ development system support- 
_ing 32-bit extended DOS, OS/2 2.x, 
Windows 3.x, Windows NT, Win32s, and 
_AutoCAD ADS/ADI. The complete toolset 
includes: C and C++ optimizing compilers, royalty-free DOS extender 
_with VMM support, licensed components from the Microsoft Windows 
_3.x SDK, interactive source-level debugger, linker, profiler, Supervisor 
_for executing 32-bit applications and DLLs under Windows 3.x, 32-bit 
‘run-time libraries for extended DOS, OS/2 2.x, Windows 3.x and 
Windows NT, and much more. 


_ List: $599 Ours: $349 
 FAXcetera # 1683-0003 

































ORDER 
Version 7.0 
NOW! 












GUARANTEED BEST PRICES! 
PROTOGEN 3.0 SS rey byte 


evelopment | To order call: 800-445-7899 
NEW VERSION! The industry standard Corporate (CORSOFT): 800 422-6507 
for code generation and prototyp- Gh! Nt FAX: 908 389-9227 
ing Windows applications. Develop the a | International: 908 389-9228 
user interface of your application using cd Customer Service: 908 389-9229 
Visual prototyping methods. ProtoGen gener- _ _ For more information on the 
ates expert level, commented code for ANSI C, A) Sees products featured on these pages call- 
Microsoft NT Win32. All generators included! MSS FAX0icra®: 908 389-8173 
User Code is preserved from one generation to 4 ‘Wy | 

the next. It’s easy and fast. 


List: $99 Ours: $89 2 1163 Shrewsbury Avenue 
_ FAXcetem # 2553-0002 . | | | Shrewsbury, NJ 07702 























THE FINEST INGREDIENTS FOR ‘ CHEFS 


hen the master chefs are working on a new recipe, they use 


only the finest ingredients. C programmers are 
no different. They need powerful and 
reliable tools to help them 
develop award winning software. 
At South Mountain Software, 
we've been helping program- 
mers develop gourmet 
software since 1983. 


/*resident_C*/ 


Essential for the parent. 
Graphics 
KERNEL, 

CHART and GUI 


This set of tools provides all you need to 
include a well balanced diet of graphics in 
your applications. Start off with the Kernel. 
This library provides the building blocks for 
fast and reliable graphics programming, and 
includes a wide array of graphics adapter 
and printer support. For the main course, 
try Essential Graphics Chart. This library 
provides a wide range of 2-D and 3-D 
charts including bar, pie and high-low- 
close. Top off your menu with Essential 
Graphics GUI, our library for 
creating graphical user 
interfaces. 


LO _ ESSENTIAL 
COMMUNICATIONS 
and BreakOut-ll 
recipe you need to prepare a professional 
2 tions application. Essential Communications 












nodem_ support, ‘multiple file transfer protocols, baud 
rates to 115K, terminal emulators and much more. 
i you need some help in debugging your RS-232 

Y Tae, BreakOut-II is the answer. This 
Now that you've seen \ product turns your PC into a serial analyzer 
what South Mountain that allows you to monitor signals, 
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(continued from page 12) 

of the undocumented features exist in 
the first place because Microsoft need- 
ed to circumvent DOS’s deficiencies in 
its own products to the same nightmare 
of incompatibility as everyone else’s, be- 
sides making it impossible to do some 
of the things that users have come to 
expect of their software. The fait ac- 
compli with which Microsoft has been 
presented is entirely of its own making. 

Is Microsoft, having been forced to 
document and maintain some of the fea- 
tures that developers (including myself) 
found indispensable, better off than it 
would be if it had presented those fea- 
tures in an orderly manner in the first 
place? Would Microsoft enjoy its present 
status among OS vendors, and would 
Bill Gates be one of the wealthiest men 
in America, if some of the first APDs 
hadn’t found unmapped routes around 
the roadblocks that DOS erected and, as 
a consequence, made their products so 
useful that they sold in the hundreds of 
thousands? When we buy an operating 
system, do we buy the whole thing or 
just those parts of it that the OSD is sure 
won't allow us to create products that 
could conceivably compete with its own? 
If I don’t have the right to use every- 
thing the OSD put into the product, 
where is my discount from the purchase 
price? Would you buy a car, Mr. Todd, 
if the manufacturer hid the fuel filter and 
then refused to tell you where it was? 

Mr. Todd’s proposal for dealing with 
undocumented features, if followed to 
its logical conclusion, presents a chill- 
ing prospect. In fact, part of it is already 
in place. A system of [leaks] “to the 
APDs of known probity” is not exactly 
a new idea, though it isn’t always clear 
just how an APD’s probity is assessed. 
The idea that “APDs may commission 
new features in the operating system,” 
of which “interested parties” would then 
be notified, and for which they would 
presumably be billed, is a prescription 
for turning the dull headache of version 
incompatibilities into an epidemic of 
unimaginable virulence. 

Finally, I would say to Mr. Todd that 
if he has ever written a DOS TSR that 
made more than trivial use of OS re- 
sources without resorting to undocu- 
mented features, he should write a 
book. It is sure to find a ready market 
among serious programmers, who aren’t 
looking for thrills when they use un- 
documented features, but for ways to 
accomplish what would otherwise be 
impossible. 

Richard Zigler 

Marion, Michigan 


DDJ 
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HOPL features top language designers 


K.N. King 


U's official. C and C++ have come of age, or at least grown 

old enough to be featured at the second History of Pro- 

gramming Languages conference (HOPL-II) held in Cam- 

bridge, Massachusetts this past spring. HOPL-II, which 

provided programming-language designers a forum for 
discussing their languages, staking their claim to immortali- 
ty, and (occasionally) taking a swipe at competing languages, 
brought together the likes of Dennis Ritchie, Bjarne Strous- 
trup, Niklaus Wirth, and Alan Kay under one roof—a rare 
occasion indeed. 

In particular, I was curious to see how the designers of C 
and C++ would be received by the proponents of languages 
such as Ada and Pascal. Despite their enormous popularity 
(or perhaps because of it), there are still academics who view 
C and C++ with suspicion. Would Wirth exchange pleas- 
antries with Ritchie or engage him in hand-to-hand combat? 
I couldn't wait to find out. 


Preserving History 

The computing field hasn’t always done a good job of pre- 
serving its own history. As time passes, our pioneers pass 
away and valuable artifacts are lost with them. For instance, 
according to HOPL-II chair J.A.N. Lee, the first Fortran com- 
piler now exists only in binary form as boxes of punched 
cards; the source code has been lost or destroyed. To help 
remedy this situation, the Special Interest Group on Pro- 
gramming Languages (SIGPLAN) of the Association for Com- 


K.N. King is an associate professor of mathematics and com- 
puter science at Georgia State University. He is the author of 
Modula-2: A Complete Guide (D.C. Heath) and is currently 
at work on C and C++ books for W.W. Norton. He can be 
reached at king@prism.gatech.edu. 
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puting Machinery (ACM) sponsored the first HOPL confer- 
ence in 1978. This conference, which covered languages in 
use by 1967, included speakers such as John Backus (For- 
tran), Alan Perlis and Peter Naur (Algol 60), John McCarthy 
(Lisp), Jean Sammet (Cobol), Kristen Nygaard (Simula), 
Thomas Kurtz (Basic), George Radin (PL/I), and Ken Iver- 
son (APL). 

This year’s HOPL-II picked up where HOPL left off. For a 
language to be eligible for HOPL-II, the program committee 
required that “preliminary ideas about the language were 
documented by 1982 and the language was in use or being 
taught by 1985.” Thus, HOPL-II was able to cover languages 
developed in the ’70s as well as upstarts like C++. 


The Worst Programming Language Ever 

In his keynote address, “Language Design as Design,” Fred 
Brooks (project manager for the IBM System/360 and author 
of The Mythical Man-Month) gave a software designer’s view 
of programming-language design. 

Brooks acknowledged that his credentials in the program- 
ming-language arena are shaky. He called OS/360 JCL, which 
was developed under his supervision, the “worst program- 
ming language ever designed.” He also ruefully admitted be- 
ing “the person who tried to displace Fortran with PL/I.” 

In his view, the data types and data structures a language 
provides must come from its intended application area; the 
Operations are then determined by the data types. Everything 
else, according to Brooks, is “languagehood.” 

Brooks also discussed “rationalism versus empiricism” in 
language design. As he sees it, rationalism (that is, design- 
ing a language by “pure thought”) is doomed to fail, since 
we have “no hope of getting our complex designs right the 
first time.” 
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Languages, Languages, Everywhere 

Most of the other presentations were by people involved in 
the original design of various languages: C.H. Lindsey (Algol 
68), Niklaus Wirth (Pascal), Per Brinch Hansen (Concurrent 
Pascal), Alain Colmerauer (Prolog), Jean Sammet (FORMAC), 
Barbara Liskov (CLU), Alan Kay (Smalltalk), Ralph Griswold 
(Icon), Dennis Ritchie (C), and Bjarne Stroustrup (C++). 

Several talks didn’t fit this pattern however. William Whitak- 
er, who oversaw the development of Ada for the Department 
of Defense, discussed the management of the Ada project, 
not the design of the language itself. Guy Steele and Richard 
Gabriel traced the evolution of Lisp, while Richard Nance 
gave a history of discrete-event simulation languages. The 
presentation on Forth was made by Elizabeth Rather instead 
of Chuck Moore, the actual designer of the language. 

A shorter talk, by someone involved with the language yet 
with a different viewpoint, immediately followed each main 
presentation. Kay was followed by Adele Goldberg, for ex- 
ample, while Stu Feldman, an early user of C and C++ and 
author of the UNIX {77 compiler and make utility, followed 
Ritchie and Stroustrup. 

Steele and Gabriel employed a “tag-team” approach in their 
presentations on Lisp. Using two overhead projectors, the pair 
alternately traced the development of Lisp on an amazingly 
detailed schematic. Still, honors for the most unusual presen- 
tation go to Alan Kay. Although his paper in the conference 
proceedings discussed the history of Smalltalk, his talk had lit- 
tle to do with the language. Instead, Kay focused on issues 
that he finds important, including the importance of general 
education instead of specialized training and the need for cre- 
ative freedom. His overheads were unique, to say the least, 
featuring pithy sayings (“You can make a doghouse out of 
anything”—in other words, it's easy to write small programs), 
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a picture of an E. coli bacterium, and a copy of The Federal- 
ist Papers (labeled “Best Book on Complex Systems Design?”). 

One potential speaker was conspicuous by his absence 
from the podium. Jean Ichbiah, the chief designer of Ada, 
had been invited to write a paper on the history of Ada, but 
declined, citing lack of time. Nonetheless, he attended and 
participated in question-and-answer sessions. 


Second-guessing 

Language designers spent a lot of time discussing the rea- 
sons for their decisions—and even indulged in a bit of sec- 
ond-guessing. Ritchie’s paper on C identified its major prob- 
lems, including “the failure of the original language to include 
argument types in the type signature of a function.” He called 
ANSI C “a noticeably better language” and acknowledged in 
later questioning that he uses ANSI C himself. 

Stroustrup was fairly happy with the decisions made in the 
design of C++. He did, however, confess to making one ma- 
jor mistake: not providing a basic class library from the be- 
ginning. As he put it, “Release 1.0...should have been de- 
layed until a larger library including some simple classes such 
as singly- and doubly-linked lists, an associative array class, 
a range checked array class, and a simple string class could 
have been included.” 

Wirth, however, refused to second-guess himself: “It is... 
fruitless to question and debate early design decisions; bet- 
ter solutions are often quite obvious in hindsight. Perhaps 
the most important point was that someone did make deci- 
sions, in spite of uncertainties.” 


Secrets of Success 
Designers also spent time analyzing the reasons for their suc- 
cess. Ritchie was modest about C’s success, even somewhat 
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The C Source Code Applications Generator. 


“The wold s fartet programmer! 
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PROGRAMMING LANGUAGES 


embarrassed by his own celebrity. (When asked if there were 
anything he’d do differently, Ritchie replied, perhaps only 
half in jest, “I’d become a monk!”) He summed up the rea- 
sons for C’s success on two overheads, titled “How to Suc- 
ceed in Language Design without Really Trying.” The first 
noted C’s widespread availability, its ability to interact with 
its environment, and its adaptability to unexpected situations. 
But the second gave the real secret: “Be lucky.” 

For his part, Stroustrup noted “the need for a program- 
ming language and the code written in it to be just a cog in 
a much larger machine” as a key factor in the success of C++, 
while Wirth said that the most important reason for Pascal’s 





success was that “many people capable of recognizing its 
potential actively engaged themselves in its promotion.” 


Exploding Myths 

Speakers often cleared up common misconceptions about 
their languages. Ritchie, for instance, pointed to the 
widespread belief that C’s ++ and -- operators were added 
to take advantage of the PDP-11’s autoincrement and au- 
todecrement addressing modes. In fact, these operators were 
present in B, the immediate predecessor of C, which was de- 
signed before the PDP-11 existed. 

Stroustrup said that he chose C as the basis for C++ be- 
cause it was “the best systems programming language avail- 
able,” not because he worked at Bell Labs, as people have 
often assumed. He also attacked the belief that C++ is suc- 
cessful because of AT&T’s marketing clout. “We once had a 
marketing budget; it was $3,000. It lasted for three years.” 


Oddities 

HOPL-II was a goldmine for trivia buffs. What do Scheme 
and Forth have in common? (Both languages originally had 
longer names that were shortened to satisfy operating-system 
restrictions. Scheme was originally named Schemer, after the 
AI languages Planner and Conniver, while Forth was sup- 
posed to be Fourth, as in “fourth-generation.” 

Which language was the first not to have goto statements? 
(Concurrent Pascal, according to Brinch Hansen, who added 
“What are you supposed to do with goto’s in a concurrent 
programming language? Where are you going?”) 

What was the origin of the // comment convention in C++? 
(Far from being an innovation, it was lifted directly from 
BCPL, a predecessor of C.) 
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(continued from page 20) 

What did the Department of Defense do before officially 
choosing Ada as the name of their new language? (According 
to Whitaker, they contacted the heirs of Ada Lovelace for per- 
mission to use her name. He jokingly wondered whether Wirth 
had gotten similar permission from Pascal’s descendants.) 

How much code is written for the DoD each day? (Two 
million lines!) 


Warfare in the Hallways? 

So how did these luminaries get along? For the most part, 
just fine. During coffee breaks, Ritchie talked to Wirth while 
Stroustrup chatted with Ichbiah. So much for my visions of 
warfare in the hallways. Similar respect was evident during 
the talks, with speakers generally avoiding direct attacks on 
competing languages. There were exceptions however. 

In his talk on Concurrent Pascal, Brinch Hansen referred 
to Ada as “large” and “incomprehensible” and C as “small” 
but “insecure.” Later, he again criticized Ada and C, going so 
far as to accuse them of not being programming languages 
at all. 

Wirth likewise attacked Ada, saying it lacked “an econo- 
my of design without which definitions become cumbersome 
and implementations monstrous.” He refrained from criticiz- 
ing C, however, until the closing panel, where he said that 
“hacking is in” and claimed that “most programmers enjoy 
working by trial and error.” Looking at Ritchie, who was sit- 
ting next to him, Wirth continued: “The most important pro- 
moter of this trend: C.” He said that languages such as C are 
useful for bootstrapping software onto a new machine, but 
their use should be only “temporary.” 

Ritchie, taking these attacks graciously, noted that Wirth’s 


points were “well-taken” and acknowledged that “it is pos- 
sible to use C in a better way than people do.” But he also 
said that “one sometimes has to make compromises” in the 
real world. 

In his earlier talk on C, Ritchie actually said good things 
about Pascal, even admitting that Pascal is “elegant.” He list- 
ed many similarities between C and Pascal, which were de- 
veloped at about the same time but without contact between 
the designers. He observed that the languages even share 
some of the same problems, such as handling arrays with 
varying bounds. 

Even Stroustrup couldn't resist a few shots at C. Of all the 
languages he used in the ’70s, Algol 68, not C, he said, was 
his favorite, noting in particular his dislike for C’s syntax and 
the loopholes in its static type checking. 


Improving SEX 

An excursion to Boston’s Computer Museum one evening 
featured the opening of what was billed as the “first-ever mu- 
seum exhibit on programming languages.” The museum had 
asked conference attendees to bring buttons, T-shirts, and 
other pieces of “programming language ephemera” which 
would later be added to the exhibit’s “Tower of Babel,” a tall 
structure listing hundreds of programming languages. 

At a banquet the next evening, Cobol pioneer Jean Sam- 
met told of being upbraided by a visiting IBM executive, who 
complained that members of her group were discussing sex 
on company time. It turned out that the visitor had over- 
heard the staff referring to a subroutine named FMCSEX by 
the last three letters of its name, which stood for “symbolic 
expression.” At the time of the visit, unfortunately, the group 
had been discussing ways to improve SEX and make it faster. 
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shops, experience reports, technical demonstrations, mation will be mailed in June 1993. If you attended Maitland, FL 32751 
poster sessions, a one-day educator's symposium plus the 1991 or 1992 OOPSLA Conferences or if Phone: +1-407-628-3602 
an exhibition of object technology products and se- you are a member of ACM/SIGPLAN, you will Fax: +1-407-628-3186 
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PROGRAMMING LANGUAGES 


(continued from page 22) 

Survival of the Fittest 

While history was clearly the focus of the conference, the 
future was not ignored. 

One important issue, of course, is the survival of program- 
ming languages as we know them. William Whitaker rhetori- 
cally asked, “Will there be languages such as Ada, Fortran, and 
Pascal in 15 years?” He answered his own question with a re- 
sounding “yes,” admitting, however, that the “growth of new 
languages will probably slow down” and “evolution will pro- 
duce dominant languages” that will “force out” weaker ones. 

Other speakers concurred. Early in the conference, for in- 
stance, Sammet noted that, of the approximately 1000 lan- 
guages implemented up to 1993, 700 are dead. Even well- 
known languages are not immune, as evidenced by Steele’s 
comment that “Lisp has been on the decline for 3—5 years.” 

Not that every language designer would be upset if his or 
her language disappeared. Alan Kay admitted that he 
“wouldn’t shed a tear” if Smalltalk disappeared tomorrow. 
Languages shouldn't hinder progress by outliving their use- 
fulness, he said. 

What will drive the development of future languages? Opin- 
ions varied, but several speakers singled out the need for 
better parallel computing support. In his paper on Concur- 
rent Pascal, Brinch Hansen stated, “I don’t think we have 
found the right programming concepts for parallel comput- 
ers yet. When we do, they will almost certainly be very dif- 
ferent from anything we know today.” 

Both Ritchie and Kay pointed out the growing number of 
people using computers, and Kay also mentioned the influ- 
ence of “pervasive, worldwide networking.” Both trends could 
have a long-term effect on programming languages. 


What should students learn as a first programming lan- 
guage? Many colleges are beginning to teach C as a first lan- 
guage. Ritchie didn’t endorse this trend. Any approach that 
tends to produce dependence on a particular language is 
bad, he said, suggesting that Scheme might be a good choice. 
Kay refused to pick a particular language. Wirth asked “Are 
you teaching a skill or [providing] general education?” In the 
former case, he recommended Ada; in the latter, he advised 
using “a simpler language”—but not C. “I view the landslide 
of C use in education as rather a calamity,” he said. 


Another HOPL? 
Will there be a HOPL-III? Probably. When will it be held? 
Maybe 5 years from now, maybe 15. 

Preprints of the HOPL-II papers appear in the ACM SIG- 
PLAN Notices, March 1993. A more complete record of the 
conference is to be published in 1994 as the book, History 
of Programming Languages-il. (The original History of Pro- 
gramming Languages, based on the 1978 HOPL conference, 
is still in print.) Reading these histories is the next best thing 
to a long chat with Dennis or Bjarne. 
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First came the best-selling 32-bit operating 
system IBM OS/2.° with over 2,000,000 copies 
sold since March 1992. 

Now comes the best-selling “How ‘To” book for 
OS/2, Client/Server Programming with OS/2 2.0. 

With over 45,000 copies sold, programmers 
are obviously recognizing the advantages of 
developing client/server applications on OS/2. 

Authors Bob Orfali and Dan Harky provide 
a comprehensive description of how to create 
and utilize OS/2 client/server applications, 
LAN communications, the DataBase Manager, 
presentation services, transaction servers and the new 32-bit 


C Set/2 compiler. 


You'll also be able to read about other client/server products, 
such as DDCS/2™, TCP/IP, CPI-C, NetWare® and Systems Object 
Model (SOM). 

Will Zachman writes that this “ATI 
book is “crammed full of rl 
information on OS/2... [it's]a 
veritable encyclopedia al stuff one 


needs to know these days.” 
For an authorized [BM dealer near you, or to 


order OS/2 2.0, call 
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Robert Orfalj 
Dan Harkey 


1 800 3-IBM-OS2. 
Client/Server 
Programming with : Cli fen t/ Ser ver 
OS/2 2.0 is available °9ramming with 
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can also order it from 
either Van Nostrand Reinhold at 1800 842-3636 (ISBN Order #0442- 
(1219-5), or from IBM at 1800 879-2755 (Order pee 


It’s just one more example of how reading can help make you a 





better writer. 


Operate at a higher level.’ 


VAN NOSTRAND 
REINHOLD 
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Is the future of C spelled “C++”? 





f the number of recently published 

books and magazine articles are 

any gauge, you'd think the future 

of C is spelled “C++.” To paraphrase 

Mark Twain, however, reports of 
C’s death are greatly exaggerated. Books 
and articles aside, C remains a proven, 
reliable, precisely defined workhorse, 
still used by many more programmers 
than C++. Furthermore, use of C con- 
tinues to grow, especially in interna- 
tionalization applications, where C is 
the language of choice. 

Since my article “Standard C: A Status 
Report” (DD/, August 1991), C has been 
buffeted on several fronts, including that 
of internationalization and, most notably, 
the surge of C++. In this article, I'll look 
at the current status of Standard C and 
Draft Standard C++. I’ll also examine fac- 
tors that could affect the future of these 
languages and discuss what is and is not 
technically and/or politically feasible. 


C and C++: Current States and Standards 

The ANSI C standard (X3.159-1989) was 
ratified in December 1989, although 
technically it was completed a year ear- 
lier. An ISO C standard followed, but— 
except for a number of minor editorial 


Rex is a member of X3/]11, a U.S. In- 
ternational Representative to ISO C 
(WG14), and convener of X3]11.1, the 
Numerical C' Extensions Group. His most 
recent books are The Dictionary of Stan- 
dard C and C++: An Introduction for 
Experienced C Programmers (CBM 
Books). You can can reach Rex at rex@ 
dussie.com or 703-860-0091. 
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and formatting differences—it was 
equivalent to that accepted by ANSI. In 
1992 the ANSI standard was officially 
withdrawn, as control of the C standard 
passed from ANSI to ISO, so that we 
now have a single standard. The upshot 
is that C is truly an internationally man- 
aged language. 

In December 1992, the ISO C com- 
mittee distributed for balloting an ad- 
dendum that added several headers and 
a large group of associated macros, type- 
defs, and functions—all of which en- 
hance the support for multibyte char- 
acters. Some digraphs also were added 
to overcome readability problems with 
terminals using the ISO 646 character 
set. This addendum will likely be ap- 





proved by the end of 1993. 

The ANSI and ISO C committees are 
now in interpretations mode. Any new 
development comes through the ISO 
committee although national commit- 
tees (such as that from the U.S.) could 
be authorized to do technical work on 
ISO’s behalf. 

There are a number of issues per- 
taining to internationalization still pend- 
ing at the ISO level, among them the 
use of national characters in identifiers. 
Other issues will surely arise, particu- 
larly as we gain experience with exist- 
ing components of the standard. (It’s 
significant to note that Microsoft’s Win- 
dows NT uses a 16-bit-based character 
set, not ASCII. With its extensive multi- 
byte support, C will grow in this direc- 
tion even further.) 

X3J11.1, known informally as the “Nu- 
merical C Extensions Group” (NCEG), 
has issued final drafts of three parts of 
its technical report. (For background in- 
formation on NCEG’s work, see “Numer- 
ical Extensions to C,” by Robert Jervis, 
DD/j, August 1992.) While this report 
does not have the power of a standard, 
it nonetheless lays the groundwork for 
additions to the language. The final re- 
port is expected by the end of 1994. 


Enter C++ 

In December 1989, an independent C++ 
standards effort (X3J16) was launched. 
It’s important to note that the X3J11 C 
committee declined to take on the job of 
standardizing C++. Certainly C++ and 
Standard C have common ancestors, but 
they were viewed as different languages. 
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The news today is the Wind/U ™ portability toolkit! Wind/U ported applications maintain identical 
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use your Microsoft Windows source base to rapidly and PCL printing support, DDE, MDI, and Common 
penetrate the fast growing workstation marketplace, Dialogs. 
or use Wind/U as a dual development environment Now you can cost-effectively 
for both Windows and Motif. run your applications on DEC, 

The advantage of Wind/U 1s that the toolkit uses IBM, Hewlett-Packard, and Sun 
the complete set of the Microsoft Windows workstations, while focusing 
application programming interface (API) facilities your programming efforts on the 
under Motif. You only need to recompile your popular Windows API. 
Windows application in the UNIX environment and 
link to the Wind/U Library. Wind/U maps the 
Windows function calls to native Motif and X calls, For more information call (203) 438-6969 or email 
allowing the Windows application to execute in the to info@ bristol.com. 


native UNIX environment. 


B ristol Technology Inc. 
Bringing the Best of Microsoft Windows to X and Motif 


241 Ethan Allen Highway Ridgefield, CT 06877 Fax: (203) 438-5013 email: info @bristol.com 


Wind/U is a trademark of Bristol Technology Inc. PCL is a registered trademark of Hewlett-Packard. Sun is a trademark of Sun Microsystems, Inc. IBM is a registered trademark of International Business Machines, Inc. 
UNIX is a registered trademark of UNIX Systems Laboratories, Inc. Microsoft is a registered trademark and Windows is a trademark of Microsoft Corporation. 
Motif is a registered trademark of the Open Software Foundation. PostScript is a registered trademark of Adobe Systems, Inc. 
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C/C++ STANDARDIZATION 
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For more information on C++ standard- 
ization, see “Standard C++: A Status Re- 
port” by Dan Saks (special supplement 
to Dr. Dobb’s Journal, December 1992.) 

Within the first year or so of deliber- 
ation, the committee decided that the 
C++ standard would be a joint ANSI/ISO 
effort. Currently, meetings are held joint- 
ly, alternating between U.S. and non- 
U.S. locations, resulting in considerably 
more international participation than the 
C standard had in its infancy. 

The C++ committee is also inventing 
much more than did the original Stan- 
dard C committee. The additions being 
considered and the set of standard class- 
es that will be defined may well result 
in the final standard being delayed be- 
yond the current goal of 1996. And 
don’t forget that when the draft stan- 
dard goes out for public review, the 
committee must respond in writing to 
every comment received. This process, 
which could easily take a couple of 
years, is repeated until no more sub- 
stantive changes are made and no ap- 
peals are pending. (Standard C went 
through three cycles.) As a result, a C++ 
standard isn’t going to become official 
any time soon. 

It is important to note that C++ is not 
a proper superset of Standard C; there 
are numerous differences. The C++ 
standards committee has a C Compat- 
ibility subcommittee that identifies the 


ust what kind of extensions should 
we make to C? While you could 
certainly consider completely new 
ideas—perhaps adding packed-deci- 
mal type or I/O statements—many 


proven extensions are already in ex-_ 


istence. Since the list (and merits) of 
possible extensions is endless and very 
subjective, I'll not discuss it further. In- 
stead, I'll identify some obvious and 
incremental ways in which C could be 
improved. 

A number of small extensions could 
be made. For example: 


e Require float and long-double math 
libraries. 

e Add extra E*value macros for errno 
(for fopen failures, for example). 

e Add I/O primitives such as “get char- 
acter without terminator” and “get 
character without echo.” 

e Add the ability to flush an input 
stream. 

e Add more LC’_*macros to sellocale and 
more locale machinery in general. 
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incompatibilities and either rationalizes 
them or suggests changes. ISO JTC1/ 
SC22 decreed that Standard C and Stan- 
dard C++ should have no gratuitous dif- 
ferences; but some differences are per- 
mitted, meaning that C++ might never 
be a proper superset of C. 

A number of other ANSI and ISO 


C++ and Standard C 
have common 
ancestors, but they 
were viewed as 
different languages 





committees are busy defining language 
bindings for C and C++. Some are also 
working on language-independent is- 
sues— parallel processing, internation- 
alization, language-independent arith- 
metic, procedure-passing methods, and 
the like—that will likely have some im- 
pact on the C and C++ standards. 


Possible Directions 

We may see a number of possible sce- 
narios played out regarding C and C++, 
among them: 


_ Extending C yn 


° Add more multibyte library suppor. : 


¢ Include binary integer constants. 


_ ¢ Allow nonconstant expressions in 


auto aggregate initializers. 


e Add new bit-field types (such a as 


char, short, long, enum). 


The following C++ facilities we 
might be considered as additions: __ 


: e //-style comments. 


e Type-safe linkage Encode ae 


tion signature in generated name). 


- @ Declarations at other than the be- 


ginning of a block. 


- @ The extended syntax for the [first 


expression in a For loop. 

e Functional notation casts. 

e Scope resolution operator. 

e Extra semantics of const. 

e Anonymous unions. | 

e Stricter compatibility checking of 
enumerated types. 

¢ Overloaded functions. 

e Inline functions. 

e Default function arguments. 





e Freeze C based on the latest ISO ad- 
dendum, thereby placing it in mainte- 
nance mode. This is quite restrictive in 
that it ignores the efforts of X3J11.1, 
doesn’t permit further work on inter- 
nationalization support or the addition 
of some interesting and useful parts of 
C++, and doesn’t cater to the extensions 
that will likely be possible (if not man- 
dated) by related standards bodies. 

e Extend C, but only in the direction 
of C++. This is also restrictive because 
it, too, ignores the efforts of X3J11.1 and 
doesn’t permit further work on inter- 
nationalization support. 

e Extend C in a number of directions, 
including C++ and internationalization. 
This isn’t restrictive and allows for the 
efforts of X3J11.1 and other subcom- 
mittees to be considered. 

¢ Formally coordinate the C and C++ 
standards committees with the long-term 
goal of merging the two languages. The 
result could be a single language, C++, 
or, the language C++ with a distinct sub- 
set called C. 


The third approach has the greatest 
potential for C and C++ diverging for- 
ever. Any changes and/or additions to 
the language and preprocessor that aren't 
also adopted by the C++ committee will 
cause both technical and political prob- 
lems. Providing new headers is a non- 
issue since these do not require linguistic 


as Oper new and delete. 
- References (although they aren’t 
much use without operator over- 


loading). 


© Requirement of a diagnostic on fail- 


ure to return a value from a non- 
_ void function. 


_ © Drop support for old-style function 


— declarations and definitions. 


¢ Requirement of a prototype in the 


scope of a function call. 


The following numeric extensions 


(X3J11.1) to C might be considered as 
additions: 


e More FP/IEEE support. 
e Extended initializers. 
e Aliasing control via keyword restrict. 
¢ Complex data types and associated 
libraries. 
e Variably sized arrays. 
e Extended integer precision 
e Data-parallel constructs. 
-—RJ. 
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business to have unbeatable RSA security features in your product. BSAFE 2.0 is the latest release of the world’s most 
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best-selling software. most advanced crypto technology into your 

It's easy, too. Becausewhenyou — existing applications. 
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RSA. Because some things are better left unread. 
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support and can readily be adopted by 
the C++ committee, provided they are 
well thought out and address a real 
problem. (Hopefully this will be the case 
with the ISO C addendum.) 

It’s worth noting that some commer- 
cial C implementors would much rather 
extend C “just a little bit more” (for ex- 
ample, adding a complex type rather 
than defining a complex class) rather 
than buying into the whole of C++. 

The fourth option—making one lan- 
suage—requires that differences be- 
tween the languages be eliminated com- 
pletely. Realistically speaking, this is 
where we are now, except the subset 


C/C++ STANDARDIZATION 


is not a proper subset, and the subset 
is the responsibility of a separate stan- 
dards committee. 


Probable Directions 
Because C and C++ are far more simi- 
lar than different, a more formal syn- 
chronization between them would be 
beneficial if, for no other reason than 
to reduce the resources required to par- 
ticipate in standards activities. 
Synchronization does, however, have 
its own problems. Currently, the C 
committees are busy interpreting their 
standard with an eye on at least some 
minor additions in the internationaliza- 
tion arena. Meanwhile, the C++ com- 


Before you hatch your next system design, 
make sure it’ll grow into something you can handle. 


Born of hot deadlines and small budgets, poorly designed software 
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mittee is working on its first standard 
using a specific project proposal en- 
dorsed by ANSI and ISO. It’s almost cer- 
tainly a bad idea to derail the current 
C++ standardization effort to include 
synchronization with Standard C. The 
setback in time and inertia would like- 
ly produce a lose/lose situation. 

The more likely alternative is to wait 
until the C++ standard is approved be- 
fore attempting some formal synchro- 
nization. Let’s say, for argument’s sake, 
that C++ is standardized in 19906. Will 
Standard C stand still in the interim? Not 
likely. Will it be extended in the C++ 
direction only? Again, probably not. In 
the meantime, if C is extended in ways 
that are incompatible with C++, syn- 
chronization will be even more difficult. 

It’s all well and good to say that if the 
C committee wants to extend C, it 
should be consulting the C++ commit- 
tee. That’s good advice, but the C++ 
committee has enough to do without 
other standards bodies bothering them. 
This isn’t to suggest the C++ committee 
is ignoring outside input, they simply 
have more interest in their own charter, 
and rightly so. 


Closing Thoughts 

Even if it were generally agreed that the 
future of C is really C++, the transition is 
problematic. Its one thing to be starting 
new projects with newly trained people 
and a new design methodology; it’s quite 
another to have a nontrivial investment 
in code and training already in place. 

The issue of object-oriented design 
and programming is separable from the 
language that implements it. While C++ 
is the commercial leader for OOP tech- 
nology, in the next decade most of the 
popular procedural languages will like- 
ly also have OOP extensions. 

Until a C++ standard is completed, C 
will probably be extended in the direc- 
tion of C++ as well as in other ways, 
some of which will also be picked up 
by C++. Once the C++ committee has 
met their original goal, some kind of 
formal synchronization plan is likely. 
Certainly informal discussion can, and 
probably should, occur long before 
then, but it’s unreasonable to expect 
anything formal until then. 

So, is the future of C spelled “C++?” 
Quite possibly, but not until the end of 
this decade at least, and maybe never. 
Formal synchronization will require 
compromise, and we all know how 
bloody territorial disputes can get. And 
while we all might want there to be one 
way, each of us wants it to be our way. 


DDJ 
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begin exploring Galaxy including a free 
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coupon below. Or, if youre ready to begin 
your Galaxy exploration immediately, 
call us now for seminar information or 
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Strategies jor Better 





Linked Lists 


A C toolkit that saves time and memory 


inked lists are fundamental tools 

used by any application that deals 

with variable types and data. The 

problem with linked lists, how- 

ever, is that when more than one 
is being used in an application, dupli- 
cate code is required to handle each list. 
This is because the type of data being 
managed by each list is different, and 
there is no simple way to educate the 
logic about the kind of data being man- 
aged at any particular moment. Linked 
lists also tend to diffuse when small 
pieces of data are being stored. 

This article discusses linked-list theo- 
ry and presents a generic linked-list tool- 
kit written in C that will reduce, if not 
eliminate, management problems. (The 
entire toolkit is available electronically; 
see “Availability” on page 5.) This dis- 
cussion focuses on doubly linked lists, 
but with a little effort the algorithms can 
be used for singly linked lists. This pack- 
age was developed using Microsoft C 
6.0; the Microsoft extensions were dis- 
abled for ANSI C conformance. 


Linked-list Strategies 

Figure 1 shows a traditional linked list 
with three links, called “atoms.” An atom 
has three parts: the previous pointer, 
which contains the address of the pre- 
decessor or Nil if this is the first atom; 
the next pointer, which contains the ad- 
dress of the successor or Nil if this is 


Garyl is the author of programming tools, 
connectivity products, and related 
subsystems. He can be reached via 
CompuServe at 76507, 1503 or through 
DDJ. 
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the final atom; and the atom data itself. 
The previous and next pointers form 
the bindery of the atom. 

The atom’s data area can be of any 
type and size, and is usually composed 
of multiple fields. An atom is easily de- 
fined in C using a structure definition 
like that in Example 1. 

Head and tail pointers define the ends 
of a list. The head pointer is an anchor 
whose value records the address of the 
first atom in the list, while the tail point- 
er records the address of the last atom 
in the list. Even though the tail pointer 
is not required (the terminating link can 
be determined by traversing the list and 
looking for an atom whose next point- 
er is Nil), it is worth the extra code and 
processing time to implement a tail 


pointer. With doubly linked lists, the tail 
pointer allows you to start at the end of 
the list and traverse upward. Head and 
tail pointers both must be declared as 
pointers to their specific atom types, as 
in FOOATOM * pHead. 

The algorithm for creating and adding 
an atom to the end of a linked list is 
shown in Example 2. In this example, 
h and tare the head and tail pointers, 
d is a pointer to an atom, and s is the 
atom size. Note that the data portion of 
the atom is never referenced. Using this 
basic template, we can create a routine 
to process any type of atom. 

To implement more generic code, 
start by defining a generic bindery type, 
then include that type as the first mem- 
ber of any atom definition; see Exam- 
ple 3(a). When processing the list, the 
atom-specific pointer is cast to a point- 
er of type BIND and subsequently 
passed to the generic logic shown in 
Example 3(b). 

By placing the bindery as the first 
member of any atom structure, we can 
fool the generic logic into handling the 
head and tail as pointers to simple BIND 
structures rather than complex FOO- 
ATOM structures. This method works 
well in most situations but is rather te- 
dious. As an alternative, define a stan- 
dard structure to hold head and tail 
pointers, as in Example 4. This way, 
only the address of the ENDS struc- 
ture—not the two pointers—can be 
passed. 

While this method is easier, it requires 
you to cast the head and tail pointers 
to a pointer of the appropriate type 
whenever needed. We can avoid this 
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LINKED LISTS 





typedef struct FOO_ATOM 
{ 


struct FOO_ATOM *pPrev; 
struct FOO_ATOM ¥*pNext; 
char szName[ 3@ ]; 
char szPhone[ 15 ]; 
FOOATOM; 


pointer to previous atom */ 
pointer to next atom */ 

foo name */ 

foo phone number */ 





Example 1; Traditional definition of an atom structure in C. 


(continued from page 32) 
inconvenience by declaring pointers as 
type void, indicating they have no as- 
sumed type. Pointers of type void can 
be assigned to a pointer of a specific 
type without casting. Notice in Exam- 
ple 5 that the value of void pointer 
pHead is assigned directly to the pFoo- 
Atom pointer (a pointer to a specific 
data type): Believe me when I say that 
even /int won’t complain about these 
types of assignments. 


Linked-list Density 

Linked-list algorithms make heavy use 
of dynamic memory functions like mal- 
locC) and freeQ). A single call to mal- 
loc() returns a pointer to a memory 
block 7 bytes long. However, for /freeO 
to work properly, the block must con- 
tain information describing the nature 
of the block. This additional overhead 
is referred to as a “memory control 
block” (MCB). If & is the size of the 
MCB, then the actual amount of core 
being occupied by a block of 1 bytes 
is n+k bytes. The actual size of the MCB 


pret = 


—- 


[pte ot 


Figure 1: Traditional doubly linked 
lists with three atoms. 


if((a = malloc(s))!= NULL) 
{ 


if (h==NULL) 
h = a; 
if (t!=NULL) 


t-snext = a; 
a-?prev = t; 


a->next NULL: 


Example 2: Algorithm for creating a 
new atom. 
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is system dependent; in some imple- 
mentations it is as small as one word, 
while in others it is as large as a para- 
graph (eight words)! 

MCB size is important because it af- 
fects the list density, which is calculated 
by contrasting the size of the data be- 
ing stored (the bang) with the amount 
of memory required to store it (the 
buck). This relationship can be ex- 
pressed as Density=nd/(k+n(b+d)), 
where 7 is the number of atoms stored 
in a mallocOed block, d the size of the 
stored data, k the MCB size, and b the 
bindery size. This is the generic formu- 
la. Since 1 is almost always 1, the ac- 
cepted form is d/(k+b+d). As the den- 
sity approaches 1, the list becomes more 
efficient. For example, a list of integers 
kept in an array has a density of 1 be- 
cause there is no overhead: The amount 
of core required to maintain the list is 
exactly that of the data being stored. 
When the value of 7 is 1, the only 
means of achieving higher densities is 
to increase the size of d by storing larg- 
er pieces of data. This makes linked lists 
impractical for storing small pieces of 
data (integers, for instance) because the 
buck drastically outweighs the bang. 


Requirements 
Taking all of this into account, a gener- 
ic linked-list toolkit should: 


1. Provide a generic set of routines for 

handling any type of atom data. 

2. Not require special considerations of 
atom data structures on the part of 
the user (that is, a BIND structure as 
the first member). 

. Increase list density. 

Make best use of system memory. 


HX Qo 


The void data type satisfies require- 
ment #1. By passing void pointers in- 
stead of pointers to specific data types, 
we can make the data appear as any- 
thing we want without /int complaining. 

For requirement #2, the linked-list 
manager handles the allocation and 
management of binderies. In effect, you 
request that an instance of the atom data 
be allocated. The linked-list manager 
then tacks on the size of the bindery, 
requests a block of that size from mal- 
locC, and retains that pointer. The point- 
er returned to the caller is to the atom 
data only; see Figure 2. This lets the user 





employ the linked list as a subsystem, 
requesting next and previous pointers, 
adding and deleting atoms, and so forth. 
However, this approach does not fully 
satisfy requirement #3 because multiple 
malloc() calls are required. 
Requirements #3 and #4 are best sat- 
isfied by allocating space for more than 
one atom at a time. By creating blocks 
of atoms at once, we increase the val- 


Linked lists are 
impractical for 
storing small pieces 
of data because the 
buck drastically 
outweighs the bang 


ue for 1, and thus the list density. How- 
ever, there is a trade-off in that memo- 
ry is allocated and can go unused. 
Therefore, you should specify the ap- 
propriate size of a block for the appli- 
cation. An application that will require 
hundreds of atoms will have a larger 
block size than one using only a few. 
Also, it is possible to store an entire list 
in a single block, thus achieving maxi- 
mum density but requiring the user to 
estimate the maximum size of the list. 


Design 
The linked-list control block (LLCB) and 
the list boundary (LLST) govern the 
linked list. The LLCB contains two sets 
of head/tail pointers, the size of the 
atom data, and the number of atoms to 
create per block. The LLST contains one 
set of head/tail pointers and a pointer 
to the LLCB; see Listing One, page 100. 
There are three types of verbs in the 
toolkit: primitives, management, and in- 
sert/move/swap. The primitives, defined 
in Ilprim.c (Listing Two, page 100), are 
ll_openQ), Il_closeQ), ll_mklistO, Il 
rmiistO, ll_allocO, and Il_freeQ. ll_open 
creates a list and //_close destroys it. 
(Table 1 describes these calls.) _openQO 
accepts the address of an LLCB, the size 
of the atom data, and the number of 
atoms to create per block, and returns 
the address of the LLCB passed to it. 
Once the LLCB is set up, one or more 
linked lists can be created using //_ 
mklist., which associates a LLST with 
an LLCB. //_mklistO accepts the address 
of a LLCB and LLST, returning the ad- 
dress of the LLST. Multiple lists, consist- 
ing of individual lists of separate atom 
chains, can be associated with a single 
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t Rogue Wave we are 
J commits to allowing 

our users to tap all of the 
power that C++ offers. For 
today’s compilers that means 
templates. Tools.h++, our best 
selling industry standard C++ 
library, now includes 
Templates! Whether you use 
template classes or non- 
templates classes, Tools.h++ is 
the ideal solution! 


Tools. h++ 

Tools.h++ is acomplete toolbox | 

of over 97 C++ classes. It is a set of 

efficient and versatile C++ 

foundation classes that will make 

virtually any programming job 

easier. 

eTime and Date handling and 
manipulation classes. 

eString and Character manipulation 
classes. 

eSingly and Doubly linked lists, 


Set, Bag, SortedCollection, 
OrderedCollection, Dictionary, Stack 
Queue, etc. 

e Regular Expression Class for search 
and replace. 

¢ Tokenizer Class for easy string 
parsing. 

e File Class to handle file manipulation 
with read, write, seek, erase, etc. 

e B-tree Class to handle efficient keyed 
access of disk records. 

e File Space Manager Class to allocate, 
deallocate and coalesce space within 
files. 

e Virtual and Buffered Page Heap to 
manage objects bigger than 64k. 

e Other classes include: Bit vectors, 
Virtual I/O streams, Cache 
managers, Error handling and many 
more! 

e All objects fully persistent. 
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Stacks, Queues and Vectors classes. 4 
eSmalltalk”™—like Collection classes: e 


Rogue Wave’s Tools.h++ is an 
“industrial strength” library used in 
many commercial applications, small 
and large. All classes have not been 
derived from a single root object, so 
they can be easily integrated with 


other class libraries. All classes have a 


Persistent Store facility that allows 
complex objects to be stored and 
retrieved onheterogeneous networks 
or the Windows 3.0’s Dynamic Data 
Exchange or clipboard facility. The 
classes are bulletproof, optimized for 
speed, and well tested. Tools.h++ is 
an excellent example of how to write 
true C++ code correctly. Source Code 
is included. All non-Windows classes 


are strictly portable between DOS and 


UNIX. 





91339 # ($03) 754-2311 













What else would you expect 
from the leading developer 
« Of C++ libraries? 









Math. h++ 


Math.h++ is a complete set 

of extremely fast C++ classes to 
handle all of your statistic, linear 
regression, FFTs, random numbers, 
vector and matrix needs. Runs on 
both DOS and UNIX. 


Linpack.h++ 

Linpack.h++ revolutionizes numerics 
by allowing you to manipulate whole 
objects rather than low level “do 
loops”, giving you all of the speed of 
Fortran and none of the headaches. 
Runs on both DOS and UNIX. 


' View. h++ 


View.h++ is a powerful and efficient 
C++ library that encapsulates 100% of 
the functionality of the industry 
standard OSF/ Motif. Runs on UNIX. 


DB.h++ 


DB.h++ is a portable alternative to 
Embedded SQL or a proprietary API. 
It enables RDBMS and ISAM 
developers to add object-oriented 
extensions to their database systems. 
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LINKED LISTS 


(a) 


typedef struct BINDERY 
{ 


struct BINDERY *pPrev; /* pointer to previous bindary */ 
struct BINDERY *pNext; /* pointer to next bindery */ 


BIND; 


typedef struct FOO_ATOM 
{ 


BIND 
char 


char 
FOOATOM; 


szName[ 3@ ] 


(b) 


void MyFunc( ... ) 
{ 


b; /* atom bindery */ 
; /* foo name */ 
szPhone[ 15 ]; /* foo phone */ 


FOOATOM *pHead, *pTail, *pAtom; 


pHead = pTail = NULL; 


pAtom 


(FOOATOM *) AddAtom((BIND **) &pHead, 


(BIND **)&pTail, sizeof (FOOATOM) ) ; 


[ other program statements ] 


BIND *AddAtom(BIND **ppHead,BIND **ppTail,unsigned usDataSize) 


{ 
BIND *pRet; 


if( ( pRet = malloc( usDataSize ) ) 


{ 
if( *ppHead == NULL ) 
*ppHead = pRet; 
if{ *pplail |= NULL ) 
(*ppTail)->pNext = pRet; 
pRet->pPrev = *ppTail; 
pRet->pNext = NULL; 
*ppTail = pRet; 
} 
return( pRet ); 





!= NULL ) 


Example 3: (a) Defining and using a generic bindery structure; (b) application 
of an atom using a generic bindery structure. 


(continued from page 34) 
LLCB. Neither //mklistO nor llopenO 
allocate memory; they only initialize 
structures passed to them. 

Atoms are created and destroyed us- 
ing /allocO and Il_freeQ, respective- 
ly. _alloc() accepts a pointer to a LLST, 
and returns a pointer of type void. 
Whenever //_alloc( is called, the LLCB 
(taken from the LLST) is checked for 
atoms that may exist in its free chain. If 
available, a free atom is removed from 
the free chain and appended to the list 
managed by LLST. The address of the 
atom data is returned. 

If free atoms are not available, an at- 
tempt is made to create a fresh block of 
atoms. A pointer to the atom data is re- 
turned if successful, else NULL to signal 
that no atoms are available nor could be 
created. A block is organized as shown 
in Figure 2. The atoms in a block are 
logically created, and because they are 
all unused, are “sewn” together by link- 
ing their binderies. The first atom in the 
block is added to the end of the free list 
in the LLCB. Figure 3 shows the results 
of a few /LallocO and Il_free( calls. 

The /_free() call accepts as arguments 


typedef struct LIST ENDS 
{ 
BIND 
BIND 
ENDS ; 


*pHead; 
*pTail; 





Example 4: ENDS structure definition. 
FOOATOM *pFooAtom; 
ENDS FooEnds; 
for (pFooAtom=(FOOATOM*) FooEnds. pHead; 
{ 
J; 


Example 5: Traversing a linked list 
using ENDS structure. 


pFooAtom; pFooAtom=pFooAtom->pNext) 


[other program statements] 





the address of an atom and the address 
of the LLST to which the atom belongs. 
The atom is removed from the current 
list and added to the end of the free 
chain maintained in the LLCB. Note that 
a usage count is maintained within the 
block bindery information. When an 
atom is allocated from the block, the 
usage count is increased. When an atom 
is returned to the free chain, the usage 
count is decreased. When this usage 
count reaches 0, the block itself is re- 
moved. 
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Greenleaf CommLib 4.0 [BiLSvawaasilely 


CommLib 4.0 contains over 300 robust asynchronous 
communications functions including XMODEM, YMODEM, 
ZMODEM, Kermit and ASCII file transfer, XON/XOFF, 
RTS/CTS, and DTR/DSR handshaking, smart modem 
control, interrupt driven serial I/O for 13 drivers usin 
consistent “Level 2" API for all drivers. Supports DOS, 
Extended DOS, and Windows 3.1. $359. 


Greenleaf PowerComm 

A native 32-bit Windows 3.1 implementation of Greenleaf 
CommLib 4.0. Extends CommLib’s capability using DLL and 
virtual device driver (VxD) to put time sensitive interrupt 
service and other routines at “Ring 0" for optimal throughput. 
Supports multiple Windows and/or DOS applications under 
Windows 3.1. Supports standard and most standard 
multi-port hardware including 16550 FIFO modes. (Requires 
CommLib 4.0) $179 


Greenleaf Comm Lib Professional 
New standard asynchronous communications toolkit for 
Windows, DOS, and 286 Extended DOS. Includes Greenleaf 
Comm Lib 4.0 and PowerComm Toolkit for Windows. $538. 


Greenleaf Comm++2.0 BDiSvassilen 


Comm++ class library includes numerous classes for asynch 
communications—from elemental hardware control classes 
to file transfer and terminal emulations (VT100, VT52, and 
ANSI). XMODEM, YMODEM, ZMODEM, Kermit, and 
ASCII file transfers. Many handshaking options. Supports 
numerous standard and intelligent multiport boards for DOS, 
Windows 3.x, and OS/2 2.0. $249 


Greenleaf ViewComm 

Lets you see data and status on the line + timestamps. 
Capture to buffer or file. Review using ASCII, hex, decimal, 
octal, or EBCDIC display. Extensive triggers: modem signal 
and string match criteria to start or stop capture. Source Mode 
lets you send from keyboard, file, or both. Configurable, 
push-to-DOS, many more features. $399. 


Greenleaf Functions 

Over 370 functions including DOS interface, keyboard, 
mouse, color text, graphics, screen & video, string, time and 
date, polled-mode serial, interrupt services and Ctrl-Break, 
equipment interface, and extensive printer support. $229. 


Greenleaf SuperFunctions 

SuperFunctions includes (over 370 functions) windows and 
basic menus (from DataWindows), Expanded Memory 
support, extensive mouse and keyboard support, DOS 
Critical Error Handler support, advanced DOS functions, an 
exhaustive set of time and date manipulation functions 
including project scheduling support, etc. No overlap with 
Greenleaf Functions. $299. 
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Greenleaf Database Librar NEW: HOT 


SoftC Database Library now published by Greenleaf Software. 
Reviewers rave about the speed and flexibility of this 
extensive “xBase” interface library. Supports dBase III & IV, 
FoxBASE+, FoxPlus, dBXL, Alpha Four, Clipper, and 
Quicksilver, including their proprietary index and memo file 
systems. Rated fastest and most compatible with C language. 

omplete ISAM database toolkit. Highly portable ANSI C 
source supports MS-DOS, Windows 3.1 (DLL included), 
portable to UNIX and OS/2. $249. 


Greenleaf DataWindows 

DataWindows 3.0 with MakeForm data entry form generator, 
a true WHSIWYG designer to create resource files. Changes 
to forms do not require recompilation! 400 functions for 
logical windows, transaction oriented data entry, and menus. 
13 installable state-change functions including fleld and form 
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Greenleaf Financial MathLib 


A unique 19-digit “DECimal” number system avoids floating 
point errors. Over 195 functions include arithmetic, error 
le test, array math, transcendentals, percentages, 
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discounted cash flow, annuities, actuarial, and general 
business functions. Modeled on the HP-12C calculator. $395. 


Greenleaf Financial MathLib++ 

MathLib++ is a C++ version of Financial MathLib described 
above. C++ iostreams are fully suported with overloaded I/O 
and math operators, so that programming is greatly 
simplified. One function call gets you a complete loan 
amortization table. Another computes the Internal Rate of 
Return of a set of discounted cash flows. $199. 


All Greenleaf Products come with reference 
manual, online documentation system (with free engine), 
FREE unlimited telephone support, FREE BBS access, 
newsletter, extensive compilable examples for each function, 
NO Royalties, 60-day money-back guarantee, and are backed 
by the industry’s most experienced tech support staff. 
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LINKED LISTS 





(continued from page 30) 

Atom Blocks and Pointer Arithmetic 

The file llbase.c (available electronical- 
ly) defines the management verbs em- 
ployed by the primitives to manage a 
linked list properly. The management 


Memory Control 
Address returned Block 


Block Header 
Address returned Atom Bindery 
Atom Data 


by malloc( ) 


by _alloc() — 


Atom Bindery 
Atom Data 


Atom Bindery 


Figure 2: The linked-list manager 
tacks on the size of the bindery, re- 
quests a block of that size from 
malloc(), and retains that pointer. The 
pointer returned to the caller is to the 
atom data only. 





verbs should never be referenced di- 
rectly by the application program. The 
management verbs are //_appatom (ap- 
pend atom to end of list), /1_mkblock 
(create atom block), /1_unbatom (un- 
bind atom from list), //_inblock (find 
block that contains an atom), /_frstatom 
(return the first atom in a list), //_las- 
tatom (return the last atom in a list), 
Il_getbind (get the bindery of a neigh- 
bor), and /1_rmblock (remove a block 
of atoms). 

The verbs /1_mkblockQ) and /l_rm- 
block() deserve some explanation. Us- 
ing mallocQ), Il_mkblock() allocates a 
block of memory large enough to hold 
the desired number of atoms (from the 
LLCB) and the block-control informa- 
tion (LLBC). This block must be carved 
up into many logical atoms, then added 
to the end of the free atom chain for 
the LLCB. This is done with simple 
pointer arithmetic. Start by calculating 
the size of an atom block. The atom 
block contains three basic types of ob- 
jects: the block header, the atom bindery 
(one per atom), and the atom data it- 
self (again, one per atom). Figure 2 il- 
lustrates the internal arrangement of an 


LLCB «Il_open( LLCB *«pList, unsigned usAtomSize, unsigned usAtomCnt ); 
Initializes a linked-list control structure. Must be the first call performed for a linked-list 
control. usAtomSize indicates the size of the atom data, and usAtomCnt indicates the 
number of atoms to create per block. This call does not allocate any memory; it only 
initializes the linked-list control structure with the values supplied. 


LLST «II_mklist( LLCB «pListCntl, LLST «pList ); 
Creates a linked list as part of the linked-list control addressed by pListCnil. 


void *«Il_alloc( LLST «pList ); 


Allocates a new atom in pList. Returns a pointer to atom data area if successful, or 
NULL if no atoms are available and none can be generated by creating new blocks. 


void Il_free( LLST «pList, void «pAtom ); 


Releases an atom to the free list. 
void Il_rmlist( LLST «pList ); 


Closes pList and releases all resources currently allocated by pList. 


void Il_close( LLCB «pListCntl ); 


Closes the linked-list control. Any resources owned by any linked lists associated with 


the control are released to the system pool. 


void *Il_first( LLST«pList ); 
Returns the first atom in pList, or NULL if pList is empty. 
void «Il_last( LLST «pList ); 
Returns the last atom in pList, or NULL if pList is empty. 


void *Il_next( void *pAtom ); 


Returns the next atom relative to pAtom or NULL if pAtom is the last atom in the list. 


void «/Il_prev( void *pAtom ); 


Returns the previous atom relative to pAtom, or NULL if pAtom is first on the list. 


void Il_swap( LLST «pList, void *«pSrcAtom, void «pTrgAtom ); 

Effectively swaps the places of pSrcAtom and pTrgAtom in pList. Both atoms are 
assumed to be members of pList, and are not checked. This can cause significant 
problems if atoms from two different lists are swapped. 


void Il_mvbefore( LLST«pList, void *~pSrcAtom, void «pTrgAtom ); 
Moves pSrcAtom before pTrgAtom in pList. Both atoms are assumed to be members 


of pList, and are not checked. 


void I|_mvafter( LLST «pList, void «~pSrcAtom, void *pTrgAtom ); 
Moves pSrcAtom after pTrgAtom in pList. Both atoms are assumed to be members of 


pList, and are not checked. 


Table 1: Linked-list toolkit verbs. 
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atom block. The formulas for calculat- 
ing the overall size of a block of atoms 
are shown in Example 6(a). 

The SizeofAtomData and AtomCount 
(which were specified when the LLCB 
was created) are taken from the LLCB. 
Given that a call to malloc( will return 
a pointer to a block of memory of ex- 


An atom has three 
parts: the previous 
pointer, the next 
pointer, and the 
atom data itself 





actly BlockSize bytes, our task is to carve 
the region into usable atoms. The first 
step is to calculate the address of the 
first atom bindery. This will be the first 
byte past the LLBC, as in Example 6(b), 
which should give us the address of the 
first bindery, right? Wrong. 

Now is a good time to point out a 
dangerous thing about pointer arithme- 
tic: The compiler is very smart, and to 
make things easier for the programmer, 
adding an offset to a pointer is the same 
as taking a subscript to the pointer, or 
pBlock+ sizeof(LLBC) is equivalent to 
pPBlocklsizeof(LLBC)/. Because the ele- 
ments of an array have an inherent size 
associated with them, the actual calcula- 
tion performed by the compiler is: 
pBind =(PLLBIND)(pBlock + (sizeof 
(LLBC)* sizeofLLBC))), which is not 
what we wanted. To get a better feel 
for what is happening here, consider an 
array of integers. The size of an integer 
on 80x86 computers is two bytes. Let’s 
assume that the base address of the ar- 
ray (the address of the first integer in 
the array) is Ox8000, and let’s also as- 
sume that we want the address of the 
fourth integer in the array. In C, we have 
to do as shown in Example 6(c). 

The inherent size of an integer is two 
bytes, so the compiler multiplies the size 
of the array item by the index to get the 
relative offset, and then adds that offset 
to the base address to achieve the ab- 
solute address, or, from our example, 
3* 2+ OxSOO00-6 + Ox8000 > 0xS000. 

If we obtained the address of the 
fourth element with the statement 
int*j=a+3, nothing would be differ- 
ent. The compiler knows that a is a 
pointer to an integer, and the index (3) 
would be modified by the size of the 
item being pointed to. This fact about 
pointer arithmetic gives us pause be- 
fore proceeding. 
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(continued from page 38) 

How do we calculate the true address 
of the first bindery? Again we use the 
power of type casting. By changing the 
compiler’s assumption about the type 
of item being pointed to, we can avoid 
the nasty problem of inherent sizes. By 
casting the pointer pBlock into a char- 


pListCntl 





acter pointer (char*), the compiler be- 
lieves that pBlock points to a character, 
which has an inherent size of 1. There- 
fore, the calculation, pBind=(PLL BIND) 
((char*)pBlock+ sizeof LBC)), will in- 
deed yield the address of the first 
bindery. Further, the address of the first 
atom data is sizeof(LLBIND)— bytes from 


pNext 


pPrev 
atom Data | 
pPrev 
| 


[pNet> 


pNext 


Figure 3: The results of a few \l_allocQ and \l_ freeQO calls. 


(a) 


TrueAtomSize=sizeof (LLBIND)+SizeofAtomData 


BlockSize 


(b) 
pBlock=malloc(BlockSize) ; 


=sizeof (LLBC) + (AtomCount*TrueAtomSize) 


pBind =(PLLBIND) (pBlock+sizeof(LLBC) ) ; 


(c) 


int al ie |: 
int *j = &al 3 1; 


/* get address of fourth integer */ 


(d) 


for( ...) 
{ 


/* calc address of next bindery */ 


pBind->pNext = 
/* setup back reference */ 


pBind->pNext->pPrev = pBind; 


(PLLBIND) ( (char *)pBind + TrueAtomSize ); 


/* go on to the next bindery */ 


pBind = pBind->pNext; 





Example 6: (a) Formulas for calculating true atom and block sizes; (b) formula 
to calculate the address of the first bindery, with errors, (c) getting the address of 
a vectored integer; (d) “sewing” the atoms of a block together. 
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pBind. However, we must again cast 
pPBind into a character pointer so that 
we aren't surprised: void*pAtom = (voids) 
((char*)pBind+ sizeof(LLBIND)),. 

At this point, however, we are not in- 
terested in the atom data area. Our task 
is to ascertain the addresses of each of 
the binderies, link them to each other, 
and then append them to the end of 
the free atom chain in the LLCB. Be- 
cause we are creating a set of new 
atoms, it follows that they are all un- 
used and will end up in the free chain 
anyway. By doing a little magic here, 
we avoid calling /_appatom( ) for each 
of the logical atoms as we locate them, 
which would use up many more cycles 
than it is worth. 


(a) 


#include "l1.h" 
LLCB ListCB; 
LLST List; 
typedef struct 
{ 


char szName[ 30 |; 
char szPhone[ 15 ]; 
FOOATOM; 


(b) 


ll_open( &ListCB, sizeof 
( FOOATOM ), 10 ); 


(c) 
ii mklist( &ListCB, &List ); 


(d) 


FOOATOM *pAtom; 
pAtom = 1l_alloc( &List ):; 


(e) 
for( pAtom = l1l_firet( &Liet ); 
pAtom; pAtom = ll_next( pAtom )) 
printf ("Name:%-30s Phone:%s\n", 


pAtom->szName, 
pAtom->szPhone) ; 


(f) 
ll_free( &List, pAtom ): 


(9) 


ll_rmlist( &List ); 


(h) 
li_elose( &ListCB ): 





Example 7: (a) Setting up list control; 
(b) initializing the list control (LLCB); 
(c) creating a list; (dz) obtaining a 
fresh atom; (e) forward traversal of a 
list; () returning an atom to the free 
chain; (g) destroying a list; 

(h) releasing the LLCB. 
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(continued from page 40) 

Now that we have discovered the ad- 
dress of the first bindery, and because 
we know that this is the first of many 
atoms to be created, we can go ahead 
and append this bindery to the end of 
the free list with a call to /1_ fappend. 
This done, we “sew” the remaining 
atoms together with the logic in Exam- 
ple 6(d). We do this once for each atom. 
When we are done, PBind contains the 
address of the last bindery in the block. 
Because we know this to be the final 
bindery of all free binderies, we will set 
the free-list tail to pBind after setting 
pBind->pNext to NULL. 

The destructor function, /1_rmblockQ), 
has a similar task—only in reverse. The 
atoms contained within a block must be 
removed from the free chain before the 
block is destroyed—or else, disaster! 
The problem is that the atoms contained 
within the block will more than likely 
not be in sequential order, as they were 
when they were created. They must, 
therefore, be removed one at a time us- 
ing the /_funbind Cunbind atom from 
free chain) call. The problem then be- 
comes how to identify which atoms in 
the free chain belong to the block be- 
ing destroyed so they can be removed 
in a graceful manner. 





LINKED LISTS 


One method is to traverse the free 
chain, using the /Linblock( function to 
determine if an atom is a member of 
the doomed block, and if so, remove it. 
With the potential of a rather lengthy 
free chain, this approach is undesirable. 

But remember that we would have 
all of the atoms readily available if only 
we could calculate their addresses. We 
did it once when we created them, and 
we do it again. We calculate the address 
of the first bindery, then call // fun- 
bind() with that address. Next we cal- 
culate the address of the next bindery, 
and so on until all of the atoms have 
been removed from the free chain. Fi- 
nally, we remove the block from the 
block chain itself, and /ree( the block. 


Using the Toolkit 

The first step in using the linked-list 
toolkit is to declare the LLCB and the 
LLST variables and a structure to hold 
the atom data; see Example 7(a). 

The next step is to initialize the LLCB 
using //_open(), passing the address of 
the LLCB, the size of the atom data, and 
the number of atoms to create per 
block, as in Example 7(b). Once the 
LLCB is initialized, we can attach an 
LLST structure to it using //_mklistO, as 
in Example 7(c). 





Now the linked list is ready to use. 
To get an atom from the list, use //_ 
alloc(), Example 7(d). To traverse the 
list, use /_firstO and Il_nextQ, as in Ex- 
ample 7(e). To remove a certain atom 
from the list, use //_free(C and specify 
the atom to remove; see Example 7(f). 
To remove all of the atoms from the list, 
destroy the list using /_rmilistO; see Ex- 
ample 7(g). Finally, to destroy all lists 
associated with a particular LLCB, use 
il_closeV); see Example 7(h). 

The test program, Iltest.c (available 
electronically), exercises every function 
in the toolkit and provides an excellent 
template for its use. 


Conclusions 

The end analysis indicates that the worst 
case of employing a blocking method 
is as good as a nonblocking one, but is 
generally better with smaller atom sizes. 
However, this consideration pales when 
compared to the benefits of using a stan- 
dardized toolkit vs. customizing each 
linked list from scratch. 
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C++ Templates 





Simplify your C++ code with templates 


here would the automobile 

industry be without cus- 

tom tools? An assembly 

line in Detroit turns out 

hundreds of cars each day, 
each having its own particular varia- 
tions of color, engine size, and acces- 
sories, all built according to a common 
plan. Since they use the same plan ev- 
ery time, automobile engineers can cre- 
ate custom tools specifically for that de- 
sign, simplifying the manufacturing of 
cars and multiplying the productivity of 
factories. 

C++ templates can multiply your cod- 
ing productivity by making it easier to 
write your own custom tools. You’re not 
producing hundreds of classes each day, 
so your productivity gains probably won't 
be as dramatic as those in the automo- 
bile industry. Still, a few well-designed 
templates in your toolkit can make your 
job much easier. 


Life Without Templates 

Suppose you’ve written a class that im- 
plements a stack of integers like Exam- 
ple 1. Of course, programming being 
what it is, the next time you have to 
write a stack, it won’t be a stack of in- 
tegers but, say, a stack of strings. You 
could reuse /ntStack by copying it, 
changing its name, and replacing int 


Pete is a software engineer at Borland 
International and is Borland’s princi- 
pal representative to the ANSI C++ Com- 
mittee. At Borland he works on Object 
Windows Library, class libraries, and 
sometimes linkers. He can be contacted 
at 1SOO Green Hills Road, Scotts Valley, 
CA 95060. 
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with a string where appropriate. How- 
ever, this approach has drawbacks. 
First, it’s error prone. You can’t just 
do a global search and replace. If you 
do, you'll end up with the member 
function JtemsInStack returning a 
string, which probably isn’t what you 
want. Doing this transformation cor- 
rectly requires you to understand ev- 
ery use of int in the original class. 
Transforming a larger, seldom-used 
class could prove to be an enormous 
undertaking. Not to mention that once 
you've done this a few times, there'll 
be several variations of stacks used by 
different programs on your hard disk. 
If you find and fix a logic error in one, 
you ought to fix it in the others as well. 
Unless you've kept scrupulous notes 
on where these variations are used, 


youll have a hard time finding them all. 

Some programmers reject templates, 
saying a stack class isn’t very big and 
you can write one when needed. Sure 
you can copy the definition of ntStack 
and, with some care, change it to a 
FloatStack in minutes—and there’s a 
good chance it will work correctly. 
However, it takes less time to create a 
FloatStack from a template: You #in- 
clude "stack.h" and typedef Stack < float> 
FloatStack. These two lines of code do 
the same as the 28 lines in Example 1. 
Don’t let anyone tell you that the other 
way is better. 


On the Inside 

These two lines of code don’t tell the 
whole story. Consider the STACK.H 
header in Example 2, the heart of the 
Stack template. If you compare this tem- 
plate with the /ntStack class, you'll see 
the two are almost identical. The tem- 
plate begins with template <class Type>, 
which tells you it’s a template that takes 
One parameter we'll refer to as Type. 
Most of the ints in the original class have 
been replaced with 7ypes in the tem- 
plate, the exception being the int spec- 
ifying the return type of /temsInStack. 
Does that sound familiar? It’s the same 
transformation that changes an JntStack 
into a FloatStack. In fact, it’s common 
to develop a template by first writing a 
class that does what’s needed for a sin- 
gle data type, then changing that class 
into a template by replacing that data 
type with a parameterized type as we 
did here. When you create a template, 
you only have to do the transformation 
once. After that, the compiler can do it 
for you. 
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“Great tools for Visual C++ 
programmers who need 


more memory” 
- Denis Gilbert, Microsoft Corp. 


“A no-compromise solution 
for Borland C++ developers” 


- Paul Gross, Borland International 


“An excellent product 
technically” 


- Glenn Axworthy, Broderbund Software 


“Gives our customers the 
memory they need” 


- Bert Love, Galacticomm, Inc. 


“A superb way of utilizing all 


available memory” 
- Dave Jewell, Program NOW, August 1991 
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completely integrated into 
286|DOS-Extender (you invoke 
286|VMM with a command-line switch) 
and enables you to transparently access 
more memory than is physically available 
in your computer. 286|VMM can improve 
the performance of applications that 
previously relied on loading and 
unloading dynamic link libraries (DLLs). 
And it’s fully DPMI-compatible, so 
programs running under Windows 
automatically use the virtual memory 
provided by Windows. 
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compilers, including Microsoft’s 32-bit 
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(continued from page 44) 

A Brief Diversion For Philologists 

The chapter on templates in The An- 
notated C++ Reference Manual (ARM) 
includes some rather confusing terms, 
such as “class templates,” “template 
classes,” “function templates,” and “tem- 
plate functions.” My Stack example is a 


class IntStack 
{ 
public: 


IntStack() : Current(Data) {} 


int ItemsInStack() const 
{ 
return Current - Data; 
} 
int Top() const 
{ 


assert( ItemsInStack() != 0 ); 


return *Current; 
3 


void Push( int i ) 


assert( ItemsInStack() < Size ); 
*Currentt+ = i; 
int Pop() 
{ 
assert( ItemsInStack() != @ ); 
return *(++Current) ; 
i, 
private: 
enum { Size = 20: }; 
int Data[Size]; 
int *Current; 


Example 1: A C++ class that 
implements an integer stack. 
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class template—a template used to cre- 
ate classes. I used it to create a Stack 
<float>, a class created from a tem- 
plate—a template class. 

The same applies to function tem- 
plates, which, as the name suggests, are 
templates that create functions. The tem- 
plate that you write is a function tem- 


template <class Type> class Stack 


public: 
Stack() : Current(Data) {} 
int ItemsInStack() const 
{ 
return Current - Data; 
} 
Type Top() const 
A 
assert( ItemsInStack() != @ ); 
return *Current; 
} 
void Push( Type t ) 
( 


assert( ItemsInStack() < Size ); 
*Currenttt+ = t; 
} 
Type Pop() 
£ 
assert( ItemsInStack() != @ ); 
return *(++Current) ; 
J 
private: 
enum { Size = 20; }; 
Type Data[Size] ; 
Type *Current; 


Example 2: Stack.h contains the 


Stack template. 
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plate. When you use that template to 
create a function, that function is a tem- 
plate function. 


Template Parameters 

Every template definition begins with 
the keyword template followed by a 
template parameter list. As in the Stack 
example, the template parameter is de- 
limited by a less-than (<) and a greater- 
than (>) symbol. The alternative of over- 
loading the meanings of {}, [], or O 
results in confusing code because these 
delimiters already have so many other 
meanings. 

The parameters in a template defini- 
tion fall into two broad categories: type 
parameters, which tell the compiler to 
expect the name of a type when the 
template is used; and nontype para- 
meters, which tell the compiler to ex- 
pect a value. For instance, Example 3 
changes the Stack template, so you 
could specify how large the stack should 
be. The difference between this and Ex- 
ample 2 is that I’ve added a parameter 
named Size to the template definition 
and removed the enum that defined Size 
in the earlier version. 

In Example 3, the first parameter is a 
type parameter, the second, a nontype 
parameter. When the class keyword is 
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used in a template parameter list, it in- 
dicates that the name following it is a 
type parameter. This isn’t the same as 
the use of class in a class definition. It 
doesn’t mean that when the template is 
used, the argument must be the name 
of a class; it only means that it must be 
the name of a type. 

When using a template, you put an 
argument list after the name of the tem- 
plate. That argument list contains the 
actual names or values that the com- 
piler should use when it expands the 
template. Where the parameter list con- 
tains type parameters, the argument list 
must contain type names. Where the 
parameter list contains nontype param- 
eters, the argument list must contain val- 
ues of the type specified for the pa- 
rameter. You’d use the two-parameter 
version of the Stack by specifying the 
type of the values and the maximum 
number of entries that the Stack holds: 
Stack<int,20> is a stack of integers with 
a capacity of 20, just like the original 
definition. 


Class Templates Create Types 

When you use a class template, you’re 
creating a type name. Don’t get con- 
fused because it’s a template—it acts 
just like any other type name. All the 


statements in Example 4 are legal, for 
example, and they mean just what you’d 
expect. When using templates, keep in 
mind that they may seem new and 
strange and have some odd-looking syn- 
tax, but they usually fit into your code 
without requiring you to do anything 
differently. That’s the beauty of good 
tools: Once you understand how to use 
them, they get out of your way and let 
you do your job. 


Gotchas 
Templates have a couple of syntactic 
quirks you should watch out for. The 
last line in the list of declarations in Ex- 
ample 4 creates a stack of stacks. It 
would be an error to declare Stack< 
Stack<int>> StackOfStacks. The prob- 
lem is that the two greater-thans (>>) 
after int in this declaration don’t termi- 
nate the two template-argument lists. 
C++ uses C’s “maximum-munch” rule, 
so the >> is interpreted as a shift-right 
operator. The compiler will give you 
strange messages if you omit the space 
between > and >. 

Parameter-list delimiters can also be 
a problem if you use arithmetic ex- 
pressions for nontype parameters. Us- 
ing the two-parameter version of the 
Stack class, you might try to write Ex- 


ample 5(a). The problem here is that 
the first > is the end of the argument 
list, so everything after that is nonsense. 
The way around this is to put the size 
expression in parentheses; see Exam- 
ple 5(b). 

Finally, you’re not allowed to over- 
load a class-template name. Conse- 
quently, you couldn’t use the Stack<class 
Type> and Stack<class Type,int Size> 
templates in one program. 


template <class Type, int Size> class 
Stack 


{ 
public: 


// same as above 
private: 

Type Data[Size] ; 

Type *Current; 





Example 3: Changing the Stack 
template so that its size can be 
specified. 


#include <stack.h> 


Staek<inty si. S23 

Stack<int> *Ptr; 

extern Stack<int> S3; 

void f( Stack<int>& ); 

class DerivedStack : public Stack<int> {}; 
Stack< Stack<int> > StackOfStacks; 





Example 4: Legal declarations using 
the Stack template. 
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Function Templates 

Function templates can be used to cre- 
ate functions. The rules for dealing with 
function templates are more complicat- 
ed than those for class templates be- 
cause functions and function templates 
can be overloaded and because we 
don’t use an explicit template-parame- 
ter list when calling a template function. 
Consider Example 6, the compiler has 
to figure out what the template param- 
eters are from the arguments used in the 
function call. In Show(/), the argument 
jis of type float. Looking back at the 
template definition, you see that the only 
parameter used in the function call is 
the template parameter 7ype. The com- 
piler infers that Type must correspond 
to float and acts accordingly. Show(f) 
acts just as if you’d written it explicitly 
to handle floats; see Example 6(b). 


Parameter Types 

One problem you can run into with 
function templates is the rule that the 
compiler does not do conversions on 
the arguments to a function template. 
This is a case where your intuition may 


(a) 


const Count = 17; 
Stack< int, Count>1@?Count:1@ > Data; 


(b) 


Stack< int, (Count>1@?Count:10) > Data; 


Example 5: (a) Attempting to use 
arithmetic expressions in the two- 
parameter version of the Stack class; 
(b) placing the size expression within 
parentheses avoids the parameter-list 
delimeter problem in 5(a). 


(a) 
template <class Type> void Show( Type T ) 
{ 


Type times2 = T*2; 
cout << T << '\t' << times2 << endl; 
} 


int main() 

{ 
float f = 3.14159; 
double d = 2.1; 
inte = 3% 
Show(f£) ; 
Show(d) ; 
Show(i); 
return @; 


) 
(b) 


void Show( float f ) 
{ 


float times2 = f%2; 
cout << f << '\t' << times2 << endl: 


Example 6: (a) Usage for function 
templates; (b) writing this function 
once with a template is much less time 
consuming than writing it for every 
data type. 








lead you astray. The template in Exam- 
ple 7(a) calculates the lesser of two val- 
ues. Example 7(b) uses this template for 
some calculations. Here, min( is called 
with two arguments of type int. The 
compiler looks at the template, sees that 
it takes two parameters of the same 
type, and figures out that if it replaces 
T with int, it has a match. The compil- 
er knows there’s a function int min 
(int,int) and calls it. Example 7(c) is 
similar to 7(b): The compiler knows 
from the template that there’s a func- 
tion jong min(ong,long) and calls it. 

Example 7(d), however, isn’t like the 
previous examples. The two types in the 
call to minQ are different. The func- 
tion template takes two parameters of 
the same type, so the compiler cannot 
use the template and the call is an error. 
The compiler doesn’t know of any func- 
tion named min( that takes a Jong and 
an int. If ’'d simply written the usual 
#define min(a,b) (M<(b)A qa): (b)), this 
call would have worked. The compiler 
would see that it was comparing an int 
and a Jong, and would perform the usu- 
al arithmetic conversions, converting the 
int argument to a Jong so that the two 
matched, and the result would be a Jong. 
That doesn’t happen with templates be- 
cause of the “no-conversion” rule. 

It’s generally agreed that the no- 
conversion rule is too harsh, and will 


(a) 


template <class T> T min( T ti, T t2 ) 
. 


recurn ti<t2.2. th ¥ TZ; 


(b) 
iit _GetMan(° int ai, int 12) 


return min( il, i2 ); 


(c) 
long GetMin( long 11, long 12 ) 
{ 


return min( 11, 12 ); 


(d) 
long GetMin( long 11, int ii ) 
{ 


return. min( 11, i1 ); 


% 





Example 7: (a) Function template to 
calculate the lesser of two values; 

(b) the compiler looks at the template 
in 7(a), replaces T with int, and calls 
int min(int,int); (c) in this case the 
compiler calls long mindong,long); 

(da) because the two types in the call to 
min are different, the compiler 
cannot use the template and the call is 
an error. 


Dr. Dobb’s Journal, August 1993 








likely change when the ISO C++ com- 
mittee reviews the rules on templates. 
Indeed, many of today’s compilers, in- 
cluding cfront, allow some conversions 
even though they’re technically illegal; 
don’t be surprised if some compilers 
complain about them. 


Overloading 

Still, it’s possible to use the example 
min( function template to compare an 
int and a Jong. To understand how, look 
at how the compiler handles overload- 
ed functions. Consider the best-match 
rules in section 13.2 of the ARM. These 
rules define the algorithm the compiler 
is supposed to use to determine which 
function to call when several functions 
have the same name. This rule was writ- 
ten before templates were added to the 
language. Templates don’t change the 
rule, they extend it. The new rule states: 


A template function may be overloaded 
either by (other) functions of its name or 
by (other) template functions of that same 
name. Overloading resolution for tem- 
plate functions and other functions of the 
same name is done in three steps: 


[1] Look for an exact match (sec. 13.2) 
on functions; if found, call it. 

[2) Look for a function template from 
which a function that can be called with 
an exact match can be generated; if 
found, call it. 

[3] Try ordinary overloading resolution 
(sec. 13.2) for the functions; if a function 
is found, call it. 


According to the first sentence, the 
declarations in Example 8(a) can all be 
used in the same program. You end up 
with two different templates with the 
same name, minQ), and an ordinary 
function prototype for a function with 
this name. That they may conflict isn’t 
important at this point. Only when you 
try to use one of these functions must 
the compiler worry about ambiguities. 
The rest of the rule addresses this point. 
For example, suppose the program con- 
tains two string variables, s7 instantiat- 
ed to “abcd” and s2 instantiated to 
“efgh”, and calls the function min¢ s7, 
s2 ). The call to minO supplies two ar- 
guments, both of type string. Declara- 
tion #2 in Example 8(a) says there’s a 
function, min(, that takes two argu- 
ments of type string. So, you have a 
function that exactly matches the call. 
According to Step #1 of the overloading 
rule, you don’t have to go any further. 

Next, consider two integer variables, 
11=3 and 12=4 and a call to min(i1, 12). 
Because the two arguments are of type 
int, Step #1 of the overloading rule 
doesn’t help here—we don’t have any 
function that exactly matches the call. 


Dr. Dobb’s Journal, August 1993 





Moving to Step #2, there’s “a function 
template from which a function that can 
be called with an exact match can be 
generated,” namely, the template min 
(T t1, T t2). The compiler can use that 
template to generate min(int,int). That 
function exactly matches the call, so 
that’s the function that will be called. 
Now consider a variable string s7= 
"abcd" and a variable char *s2="defg". 
The call string min(s1, s2) doesn’t sat- 
isfy either Step #1 or #2. We haven't 
seen the definition of this string class, 
but from its use you’ve probably figured 
that it has a constructor that takes an ar- 
gument of type char*. The constructor 
is used to create the auto strings we’ve 
been passing as parameters. The com- 
piler could use that constructor to call 
min(string, string) by creating a tempo- 
rary object of type string and using that 
temporary object as the second param- 
eter. That’s just an ordinary function call, 
and it’s done just as if the template 
weren't present. Step #3 says that’s what 
the compiler should do in this case. 
Step #3 also tells us what we need 
to do to persuade the compiler that it’s 
okay to call minO with an int and a 
long—tell the compiler there’s a ver- 
sion of min() that takes two J/ongs. 
Once that’s done, the compiler will use 
Step #3 of the overloading rule and 
promote the int parameter to a Jong. 
You don’t have to supply a definition 
of this particular variation as long as 
the compiler can generate it from the 
template. By supplying a prototype, 


(a) 


template <class T> 

og 0 Ma 9. cs 7 

string min( string,string ); 
template <class T> 

T win€ T tipseeres. 25: 3 


(b) 


template <class T> 
T min( T tl, hte) 
(C-return t1 eget) +s t2; } 


int main( int argc, char *argv[] ) 


return atoi( min(argv[1],argv[2]) ); 


(c) 
char *min( char *si, char *s2 ) 


if ( eteemet at, a2 )7<.0-) 
return sl; 

else 
return s2; 





Example 8: (a) These declarations 
can all be used in the same 
program; (b) a variation on the 
template class in 8(a); (c) definition 
of min(char *, char *) that calls 
strempQ instead of comparing 
pointers. 
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you make the call legal. By supplying 
the template definition, you give the 
compiler a way of producing the ac- 
tual function. 


Template Specializations 
Step #2 of the overloading rule says to, 
“look for a function template from 
which a function that can be called with 
an exact match can be generated, if 
found, call it.” It doesn’t say “generate 
the function and call it.” That’s quite de- 
liberate. The compiler simply generates 
a call to the function that has that name. 
You can provide your own version of 
that function somewhere else in the 
code; if you do, that function will be 
called when the program is run. 
Consider Example 8(b), a variation 





: limited - io type 
first described a: 
| he Annotated C os 


envied programm rs ir | 
| ronments 2 could 


streams R Road, 
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C++ TEMPLATES 


of the min(V example, which, though 
admittedly contrived, is supposed to 
take two command-line parameters (text 
representations of numbers) and return 
the lower value of the two. Unfortu- 
nately, it doesn’t work because the 
min() template, when applied to two 
chars, compares the pointers, not the 
C strings they point to. This is where 
specialization comes to the rescue: You 
can provide your own definition of 
min(char *, char *) that calls strempO 
instead of comparing pointers; see Ex- 
ample 8(c). 

If this function appears anywhere in 
the program, even in a different mod- 
ule from the one that contains the call, 
then it should be invoked at run time. 
The ibis should not be used. Think 





of template instantiation as a desperate 
measure, to be used only when noth- 
ing else works. The compiler uses the 
overloading rules to figure out what call 
to make, then tries to find an ordinary 
function to handle the call. If there’s no 
ordinary function, it will instantiate the 
template. 


Forward References 

Notice in Example 8 that I used a for- 
ward reference to the min() tem- 
plate. This works much like a func- 
tion prototype, telling the compiler 
there’s a function template named 
min() that takes two parameters of 
the same type and returns a result of 
that type. That’s all the compiler 
needs to know to call functions cre- 
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ated with this template. Of course, it 
eventually has to see the actual def- 
inition, but the definition doesn’t 
have to appear until later; see Ex- 
ample 9. When you don’t want to or 
can’t expose the template definition, 
you can tell the compiler that some 
name is, in fact, the name of a tem- 
plate. Of course, if you haven't giv- 
en the compiler the definition of the 
Stack template, you can’t use that 
template in any way that depends on 
its definition. 


Template Instantiation 
But what happens when the compiler 
actually expands the template? Where 
does it put the code that the template 
creates? These details depend on the 
compiler. 

cfront, for example, requires you to 
put class-template declarations and cor- 
responding inline functions in a head- 
er file, and non-inline member-function 
definitions in a file with the same base 
name as the header file, located in a 
special directory so that the compiler 
can find it. Each time the compiler in- 
stantiates a template, it sticks the code 
into a special area known as a “repos- 
itory.” During linking, the linker looks 
in the repository for the template in- 
stantiations that it needs. If a particular 
instantiation isn’t there, the linker has 
to call the compiler to create it. 

Borland C++, on the other hand, re- 
quires you to put everything in the 
header file. It compiles the code directly 
into the .OBJ file where it’s used. The 
linker combines duplicate template in- 
stantiations, so your executable file only 
ends up with a single copy of the code 
for any particular instantiation. What- 
ever compiler you use, once you’ve set 
things up properly, you shouldn’t have 
to do anything special to get templates 
instantiated. The compiler should take 
care of it. 


Templates in Your Tool Kit 

One of the greatest advantages of C++ 
over C is that it supports inheritance, 
which allows you to factor out common 
features into single class. This improves 


template <class T> 
Painter, TT e2 ); 


ant tenet ait 412 ine 22.) 


return min( 11; 12>). 


template <class T> 
T pint, 7.41, 7: t2°) 
{ 


Perret. s C2. 2 Ctl .< E25 


Example 9: A forward reference to a 
template works much like a function 


prototype. 
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maintainability and gives you a set of | References 
reusable building blocks for future use. 

Templates extend this form of gen- 
eralization by enabling the creation of 
families of similar classes and functions. 
Your understanding of a problem often 
changes during the development of an 
application, which means you constantly 
adapt building blocks to the changing 
requirements. Having a well thought-out 
set of templates makes these adaptations 
much easier and much less error prone. 


Wesley, 1992. 
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Calling C Functions with 


Variably Dimensioned 


Arrays 





Bringing C up to snuff, Fortran-wise 


ith the growing popularity 

and acceptance of UNIX, 

many scientific and engin- 

eering programmers are 

switching from Fortran to 
C to code their technical applications. 
Both languages allow for compilation of 
individual source modules and are there- 
fore ideal for creating general-purpose 
subroutines that can be incorporated into 
libraries that can then be used in a wide 
variety of applications. 


The Multidimensional-array Problem 
However, when it comes to passing 
multidimensional arrays to a function or 
subroutine, C is drastically inferior to 
Fortran. Fortran has an elegant mecha- 
nism that allows a calling program to 
pass an array with adjustable dimen- 
sions to a subroutine—the actual di- 
mensions can be passed to the subrou- 
tine as one of the subroutine parameters. 
This allows us to write a completely 
general-purpose Fortran subroutine. 

Such is not the case for C functions, 
however. The C compiler wants to 
know the absolute size of all but the 
first dimension of any arrays passed to 
a function. For instance, you can get 
away with calc(int n, float xf) {... but 
not calc(int n, float x{][) {.... 


John is a computational scientist in the 
University of Toronto’s high-performance 
computing group. His interests include 
scientific programming on vector and 
massively parallel supercomputers. John 
can be reached through the DD} offices. 
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C can deal with variably dimensioned 
vectors (one-dimensional arrays), but 
when an array has more than one di- 
mension, the C compiler has to know 
the size of the last dimensions ex- 
pressed as a constant. This is a glaring 
shortcoming to scientific programmers, 
whose entire data structures are often 
based naturally on two- and three- (and 
higher) dimensional arrays. It’s not re- 
ally surprising, though, when we con- 
sider that C was conceived as a sort of 
high-order systems-programming lan- 
guage. Systems programmers general- 
ly don’t need multidimensional arrays— 
certainly not those with variable 
dimensions. 


Unsatisfactory Solutions 
This problem has long been recognized, 
of course, and those who work with nu- 
merical applications in C have devised 
various solutions to the problem. An ob- 
vious solution is to go ahead and de- 
clare the arrays in the functions to be 
an absolute size and hope that no big- 
ger arrays will ever be required. This 
can be wasteful of memory in most cas- 
es, and seldom will you be sure what 
the maximum array size should be. 
The usual solution is to construct mul- 
tiple-dimension arrays as vectors of 
pointers, eventually pointing to a vector 
of the required data type. For instance, 
a matrix of floating-point values (a two- 
dimensional array) would be declared 
as a vector of type float *, with each el- 
ement pointing to a vector of type float. 
This works, but has serious short- 
comings. It's probably acceptable in a 
program being written from scratch, but 
not in designing a subroutine that will 
find its way into a library or will be 
reused in other programs. The problem 
is that the calling program must be aware 
that the function expects arrays to be 
defined this way and must define all ar- 
rays in this fashion. This means that any 
other computations done on the arrays 
must take this special structure into ac- 
count. What we get is a case of the tail 
wagging the dog—the array structure 
imposed by the function influences 
whatever else the main program does 
with these arrays. This limits portabili- 
ty—someone who wants to use a func- 
tion that assumes arrays are defined in 
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this way may be unwilling or unable to 
change the definition in his or her main 
program. It also violates the principle of 
information hiding, which is fundamental 
to the top-down structured design pro- 
cess. High-level routines should not have 
to know or care what data structures are 
used by lower-level routines. 


The Easy Solution 
Still, it is possible to pass to a C function 


multidimensional arrays which the func- 











EC a an 
Example 1: (a) The generic matrix 
multiplication algorithm consists of 
three loops; (b) the pattern used if 
multiplying the matrices by hand; (c) 
the algorithm for accessing all matrix 
elements as consecutive storage 
locations under Fortran’s array- 
storage pattern. 


naa 





ata 


Example 2: An algorithm that 
accesses its arrays in storage order 
using C's array-storage scheme. 
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VARIABLY DIMENSIONED ARRAYS 


tion can treat as having variable dimen- 
sions, and to do so in a fashion trans- 
parent to the calling program. It is not 
necessary to define the arrays in a spe- 
cial way in the main program. Experi- 
ence has shown me that this can be done 
by adopting the following principles: 


e Pass the array to the function as 
though it were a pointer to a vector of 
floats (or the appropriate data type), no 
matter how many dimensions the array 
actually has, along with the dimensions 
of the array. 


There is one area 
where C is drastically 
inferior to Fortran: 
passing 
multidimensional 
arrays to a function 
or subroutine 


e Reference individual array elements 
as Offsets from this pointer. For exam- 
ple, for a two-dimensional array A, 


element a,, has an offset of ncolxit+j 
from *a, where ncol is the number of 


columns in the array. This idea can be 
extended in a straightforward manner to 
arrays with more than two dimensions. 

e Write your algorithm so that array 
elements are accessed in storage order. 


a 


Example 3: The C function matmul, 
which multiplies two matrices together. 





This is really the key principle to mak- 
ing this technique work. It allows us to 
access subsequent elements of the ar- 
ray using the postincrement operator 
(for instance, *a++) and eliminates the 
need to calculate offsets for individual 
array elements. As a side benefit, algo- 
rithms written this way are generally 
faster than those using array subscript 
notation. 


To apply these principles successful- 
ly, it helps to be comfortable program- 
ming and reading code written in C. 
Otherwise, applying the aforementioned 
principles can make the code appear 
somewhat obscure. 

To illustrate the procedure, I’ll use an 
example of multiplying two matrices to- 
gether—a basic linear-algebra subrou- 
tine that has many arithmetic operations. 


Matrix Multiplication 

Before looking at the example, I’d like 
to briefly consider the topic of matrix 
multiplication on computers in general. 
Our task is to compute the product of 
two matrices A and Band store the re- 
sult in C. From linear algebra we know 
that if A and B have dimensions mxn 
and nxp, respectively, then C will have 
dimensions mxp. The generic matrix- 
multiplication algorithm consists of three 
loops; see Example 1(a). 

The loop indexes and termination 
points have been left blank. They will 
have names 7, 7, and kand values m, n, 
and p, respectively. There are six pos- 
sible permutations for arranging the 
loops. Each does the same operations, 
but they have very different memory- 
access patterns. The pattern used in 
standard linear-algebra texts, which we 
would use if multiplying the matrices 
by hand, is shown in Example 1(b). 

Elements in matrices A and C are ac- 
cessed in row order. However, since 
Fortran stores arrays in column-major 
order, this does not access consecutive 
storage locations. We would prefer to 
access all matrix elements as consecu- 
tive storage locations, so we should use 
the algorithm in Example 1(c). Note that 
this algorithm performs exactly the 
same operations as the first, but in this 
case we access successive array ele- 
ments by going down the matrix 
columns. Since this is the way Fortran 
stores arrays, we’re also accessing con- 
secutive locations in memory. This al- 
gorithm does very well on vector su- 
percomputers, such as those from Cray 
Research, since it eliminates memory- 
access conflicts and also lends itself well 
to vectorization and chaining. This al- 
gorithm also does better than the first 
on scalar machines, like workstations 
or PCs, since we maintain coherency 
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(continued from page 54) 
of the data cache and minimize page 
faulting. 


An Example in C 
We would like to maintain the same 
memory-access pattern in C, but since 
C stores arrays in row-major order, we 
have to use a different permutation of 
the algorithm; see Example 2. Now that 
we have an algorithm that accesses its 
arrays in storage order, we can imple- 
ment it as a C function; this is done in 
Example 3. 

Note how the principles outlined ear- 
lier are adhered to. The dimensions of 
the arrays m, n, and p and the arrays 
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themselves are passed to the function. 
The arrays are treated as pointers to vec- 
tors of floats even though they are two- 
dimensional arrays. We would treat them 
the same if they had three or more di- 
mensions. 

Within the function, wherever pos- 
sible, we set pointers to the arrays (or 
subsets of the arrays) and access sub- 
sequent array elements by incre- 
menting these pointers. This works 
because we have designed our algo- 
rithm to access array elements in stor- 
age order. 

In this case we have a very compact 
function that will work with any size ar- 
rays, just as though we were working 
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Example 4: C main program to test 
matrix-multiplication function. 


in Fortran. As a bonus, this version ex- 
ecutes about twice as fast as the same 
algorithm coded using explicit subscript 
references (as tested on a RISC work- 
station and a PC clone). 

Example 4 shows a sample main C 
program that defines storage for three 
matrices, initializes two of them, and 
calls the matrix-multiplication function 
matmul to multiply them together. Note 
that we don’t have to do anything spe- 
cial when defining the arrays—they are 
just defined as standard two-dimensional 
arrays. 

One thing you might want to change 
about the main program is the line that 
calls the matrix-multiplication routine. 
C compilers that support prototyping 
will warn you that the argument types 
don’t match the prototype descriptions, 
though it will still compile and run. Call 
the function casting the arrays as point- 
ers to vectors of floats, for example, 
matmul(M, N, P. (float *)a, (float *)b, 
(float *)c); and everything will be fine. 


Summary 

It’s possible to write functions in C that 
allow you to treat arrays as being vari- 
ably dimensioned, the same way For- 
tran does. Just pass the arrays to the 
function as though they were pointers 
to vectors. With some thought, you 
should be able to write your algorithm 
so that it accesses the array elements in 
storage order (that is, by row). This can 
then be coded by incrementing point- 
ers to the arrays, resulting in a fast and 
efficient implementation. 
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Image Databases 


Indexing 





A search algorithm implemented in C++ 


maging systems require a way to 
store and retrieve large amounts of 
unstructured data. At the New York 
Office of Mental Health, for instance, 

~ We estimate that at each of our 30 
facilities there might be as many as 
100,000,000 documents to be archived. 
However, the stability of vendors offer- 
ing archiving tools is often suspect. Un- 
deed, some of the software we’re using 
was provided by a leading vendor who 
has since filed for Chapter 11.) Conse- 
quently, we needed an indexing system 
that would allow many different image- 
file formats, be simple enough to test 
and implement within the project time 
allowed, but not lock us into any ven- 
dor-specific solution. 

Typically, a document image system 
uses at least two files to store and re- 
trieve documents. The first is a tradi- 
tional file that has a text description of 
the image along with a key to a second 
file. The second file contains the docu- 
ment location. The user selects a record 
from the first file using a search algo- 
rithm. This front end can be complex, 
as when the system supports keyword 
searches, or even icons of the docu- 
ments. Once the user selects a record, 
the application keys into the location 
index, finds the document, and displays 
it. The name of the image to be dis- 
played is not important to the user and 
is often generated by the system. The 
second file can be any traditional in- 


Art works in the Technical Services 
Group for the New York State Office of 
Mental Health. He can be reached on 
CompuServe at 75730,3070. 


60 


Art Sulger 





dexing structure. In this article, I'll dis- 
cuss the search algorithm used in this 
second file to locate images. 

Our first attempts used published 
B-tree code. Because the image file- 
names did not have to be readable or 
intelligent in any way, we generated a 
meaningless sequential name, similar to 
impnam in stdio.h. We wrote some 
batch-testing programs that generated 
thousands of filename keys and stored 
them in our B-tree. The filenames were 
14 characters long, a length that caused 
some concern. Large data items in 
B-trees cause the tree to be deeper and 
larger. Disk thrashing ensued, and all 
we proved was that B-trees don’t han- 
dle ordered data very well. Obviously, 
we needed to build random names. Be- 


fore heading down the path of hash ta- 
bles and random generators, however, 
we found a better way. 


The Mapper 
One of the fastest ways to locate data 
in a file is by going to a direct offset 
into a file. In C, you can do this with 
the /seek or fseek functions. We could 
store any location directions we wished 
at the chosen offset. This would yield 
very fast search times, and there would 
be less worry about the size of the lo- 
cation entry. Even the size of the loca- 
tion entry is reduced by using the im- 
age filename itself to derive an offset 
into a “mapper” file which contains di- 
rections to locate the image. 

For example, to store the location of 
a file named C:\AA\12345678.TIF, we 
create an entry in the mapper file that’s 
at a 12,345,678-byte offset. At this loca- 
tion, we store the device, subdirectory, 
and file extension. Encoding and decod- 
ing the image filename to and from a 
meaningful offset is simple. Fortuitous- 
ly, the 4-byte long value needed by or 
lseek can be represented by the eight 
hex characters which form the filename. 
They're decoded as offsets into the map- 
per file. We’ve encapsulated the func- 
tions to manipulate these index entries 
in the mapper class written in C++. 

The Mapper class header (see Listing 
One, page 104) contains a member 
struct that describes the layout of a map- 
per record. You should tailor this to your 
needs. The struct we’re using is shown 
in Example 1. The device member is 
the drive letter. The path is a 2-byte di- 
rectory entry. A DOS path label may be 
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Just Add 


If you are moving a 500,000 line 
mainframe program or have a 
program that requires a DOS 
extender, EM/32 is the PC 
Fortran language system for you. 


This highly optimized, 32-bit 
Fortran supports the full ANSI 
77 Standard, DEC VAX and IBM 
VS extensions, and important 
Fortran 90 features. The royalty- 
free Phar Lap DOS-Extender 
handles programs as large as 
4GB. In addition to providing 
virtual memory, VCPI, and XMS 
support, the extender is DPMI 
compliant. Youcan compile, link, 
debug, and run your program in 
DOS, DESQview, and the DOS box 
of Microsoft Windows and OS/2. 


When writing new code, you can’t 
beat our compilation speed, 
unmatched error messages and 
new 32-bit debugger/profiler. 
Tools include an editor, make 
utility, library manager, and 
graphics library. If you should 
have any difficulties, we provide 
free unlimited technical support. 


Your Fortran code is important. 
Trust it to the company that 
has been writing award- 
winning Fortran language 
systems for over 25 years. 


Contact us about EM/32 or any of 
our other Fortran language systems. 


(800) 548-4778 





Fortran is our forte 


30-Day Money-Back Guarantee 


Tel: (702) 831-2500 m Fax: (702) 831-8123 
P.O. Box 6091 m Incline Village, Nevada 89450 
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(continued from page 60) 

any alphabetic character or digit, as well 
as one of the following: !_-@#$%A 
& () ~ > { }. In other words, there are 
50 possible single-character paths avail- 
able: 50x50+50=2550 directories on each 
device. We can tell which image view- 
er to use based on the FileExtension 
member. A .TIF extension will call the 
TIFF viewer, a WP5 extension will call 
the WordPerfect viewer, and so on. If 
your application uses a more intelligent 
viewer, you could drop this member. 

The larger this struct is, the fewer 
mapper entries you'll be able to write. 
But don’t get too ambitious in keeping 
the struct slim. Few systems have the 
need or the space to store as many files 
as the 6-byte struct given in this exam- 
ple (2?*/sizeof(struc)=715 million); see 
the text box entitled, “How Much Can 
We Store?”. 

At minimum, the struct should indi- 
cate whether the document is stored on 
a magnetic drive or on a removable, 
probably optical, drive. If you’re using 
a removable optical drive, also known 
as an “autochanger” or a “jukebox,” 
you'll need to store the directory infor- 
mation. Jukeboxes are treated as a sin- 
gle device, and each platter looks to the 
programmer like a subdirectory. Note 
that by storing the device in a file sep- 


struct Mapper 
{ 


char Device ; 
char Path [2] ; 
char FileExtension [3] 





Example 1: The member struct that 
describes the lie — a mapper record. 


Bo when pes into i _ : € 
_Cessing, disk sizes s suddenly s een 


andl often, if you plan to store e'your 
ages on magnetic disk, a at a tir 
you may be in for a surprise. DOS © 


- million or so im 


uses a file-allocation table (FAT) to lo- 
cate disk clusters. Each file will occu- 
py at least one cluster. The FAT entry 
on DOS fixed disks larger than ie 
megabytes is 16 bits long. So even th 
largest drives available, 2 gig 


will limit you to about 64K file Gs. 
suming that each file is <=32K). You ~ 
will require 16 2-gigabyte drives to 








arate from the user interface you can 
easily update storage-location changes. 
If you write an archiving application, 
for example, you will only need to up- 
date one byte in the mapper file. 


Multipage Documents 

It would be nice if our imaging system 
could handle documents that have more 
than one page. Treating multipage doc- 
uments is a little more complex. We still 
store the location information for each 
document page in the mapper file. A 
second file contains a doubly linked list. 
Each linked-list entry also points at a 
single mapper-file entry. This allows us 
to scan forward and backward through 
the document’s pages. A separate 
LinkedList class handles file I/O to a 
linked-list file. The header is in Listing 
One (page 104), and the methods of 
this class and the Mapper class are in 
Listing Two (page 104). The layout of 
the linked-list file is shown in Example 
2. Notice that the linked-list structure is 
larger than that of the mapper. You'll 
have to estimate the ratio of multipage 
to single-page documents. If every doc- 
ument is multipage you may consider 
using a singly linked list, which will elim- 
inate one-third of the space required for 
the linked-list entries. The drawback, of 
course, is that the application will have 


struct LinkedList 
{ 


unsigned long Prev ; 


unsigned long MapperOffset ; 
unsigned long Next ; 


Duos 





Example 2: Layout of the linked-list 
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to write its own routine for scanning the 
pages of a document in reverse. 

Listing Three (page 105) contains the 
code for a program that exercises the 
Mapper and LinkedList classes. It writes 
out 1000 single-page document entries 
and 1000 four-page document entries, 
then reads them back. 

The Mapper and LinkedList objects 
are contained in and contain other ob- 
jects. ’'ve omitted a class that provides 


We needed an 
indexing system that 
would allow many 
different image-file 
formats and be 
simple enough to test 
and implement 
within the project 
time allowed 





extensive error messages. If there are 
run-time errors in this example, the ob- 
jects will return a NULL if a character 
value was expected and a —1 if an in- 
teger value was expected; a 0 returned 
usually signals success. 

The locking calls are compiler spe- 
cific (Zortech), but I left them in to in- 
dicate likely places you should lock out 
other users. Scanners take several sec- 
onds, during which time you won't want 
your initialized index space updated by 
another scanner user. Turn off locking 
by defining NOLOCK=0. 

You use the Mapper class to create 
the name of the image file. The Lock- 
Spot method does this and also locks 
the new record space in the mapper file. 
This might be necessary if more than 
one scanner is in operation. The file- 
name returned does not include the ex- 
tension. 

You retrieve the location of the im- 
age file with the Read method which 
will construct a fully qualified filename. 
Essentially, this method returns the lo- 
cation instructions. You could expand 
these instructions beyond a simple file 
specification. 

You should call Write after LockSpot. 
First your application will get the file- 
name via LockSpot. Then you will scan 
the document using that filename. Fi- 
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nally, you'll write this information in the 
already locked and initialized MAP- 
PER.DAT file. 

At some time during the creation and 
storage of the image, you should get 
the long value that is the offset into the 
mapper file. This is done with the 
IMAPSSLOT number. If you’re combin- 
ing single- and multiple-page images, 
you'll indicate that the offset is to the 
Mapper by keeping it a positive value; 
offsets to the LinkedList are converted 
to a negative number. 

Your application must know before 
creating the index whether the docu- 
ment is to have a single or multiple 
pages. Multipage documents can be 


COMPUTER 


LANGUAGE 


PRODUCT 


A 


#include <stdio.h> 


#define FLAG 0x04 


int testflag( unsigned u ) 


{ 

att u & FLA == 
else return 1; 
} 


int main() 
{ 
printf£( “%d\n"”, 
return 0; 


} 








stored and then retrieved in the same 
order. If the scanner operator picks mul- 
tiple pages, your application wifl create 
an instance of the LinkedList class and 
call the LockSpot method. After getting 
a LinkedList slot, LockSpot gets the next 
available mapper slot and saves the val- 
ue in the MapperAddress member of the 
LinkedListBuffer. The mapper value in 
hex is the filename you will use when 
scanning. This function returns a point- 
er to the Mapper value. 

For the second and all subsequent 
pages, after you have called LockSpot 
and stored the next page of the image 
file, use Linkin to link the previous page 
with a call to this member. 


5.0 presents 
C Bug #514 


0 ) return 0; 


testflag( O0x1B ) ); 


Why does this program print ‘I’ rather than ‘0’? Call if you need a hint. 


Refer to Bug #514. 


PC-lint will catch this and many other 
C bugs. Unlike your compiler, PC-lint 
looks across all modules of your 
application for bugs and inconsistencies. 


More than 330 messages. Includes 
optional Strong Type Checking and 
flow of control analysis. More than 105 
options for complete customization. 
Suppress error messages, locally or 
globally, by symbol name, by message 
number, by filename, etc. Check for 
portability problems. Alter size of 
scalars. Adjust format of error 
messages. Automatically generate ANSI 
prototypes for your K&R functions. 


Attn: Power users with huge programs. 


PC-lint 386 uses DOS Extender 
Technology to access the full storage 
and flat model speed of your 386. 


PC-lint 386 — $239 
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30 Day Money-back Guarantee. 
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Too late. 


At Microsoft, 
we don’t wait 
for the word 
“Go.” 
By then we’ve 


already gone. 


Don’t miss us 
at Software 
Development 93, 
August 23-27 


in Boston! 


We are determined to stay ahead of the field in workgroup 
technology, distributed computing, development tools, digital 
communications, and more. The will to win, the drive to 
make it happen and the vision to anticipate the next 
technological wave will give you a head start at Microsoft. 

If you are interested in learning more, come meet with 
Microsoft Managers at SD ’93 and talk candidly about 
what’s going on at Microsoft and how you might contribute. 


Software Design Engineers 
As a Software Design Engineer you will be involved 
with all phases of development. You will work with small 
dedicated teams of world class Software Engineers design- 
ing new and sophisticated Microsoft products and estab- 
lishing the future of personal computing. Positions are 
Redmond, WA based. 


Technical Program Managers 
As a Program Manager you will be the product’s tech- 
nical catalyst, owning the development from inception to 
release. You will write the product specifications and drive 
all aspects of development, from implementation and test- 
ing through marketing and delivery of the latest Microsoft 
products. Positions are Redmond, WA based. 


Senior and Principal Consultants 
As a Consultant you will be involved in the design and 
development of client server solutions. We are looking for 
candidates with 3+ years Windows SDK development and 
2+ years client server development in a PC environment. 
Previous consulting experience and excellent communica- 
tions skills are essential. Email/Networking experience a 

plus. Positions are available throughout the Northeast. 


Systems Engineers 

As a Systems Engineer you will use Microsoft language 
products and development tools to help ISVs and OEMs 
develop state-of-the-art software, design and prototype 
computer solutions and consult with Fortune 1000 corpo- 
rations on technical issues. Qualifications should include 
1+ years C programming experience, excellent communi- 
cation and problem solving skills. Positions are Redmond, 
WA based. 


Anticipate. 
Don’t wait for the momentum, create it - with 
Microsoft. Send a resume to reserve a spot. We’ll get back 
to qualified individuals with details. Send your resume to: 


Microsoft Corporation, Attn: Recruiting 
Dept. A2830-0893 
One Microsoft Way 
Redmond, WA 98052-6399 


Or bring a resume to SD ’93 and leave it (Attn: 
Microsoft Recruiting) at the Sheraton Hotel and Towers 
front desk. Indicate your local (hotel) phone number so 
we can contact you in Boston. Also, please feel free to 
stop by our Hospitality Suite at the Sheraton...call 
(206) 936-5184 for day and time. 

If you can’t make it to SD ’93, we would still like to 
hear from you. Please indicate on your cover sheet that you 
won’t be attending. No phone calls please. We are an equal 
opportunity employer and support workforce diversity. 








IMAGES 


You'll want several members to make 
it easy to traverse the linked list. Last- 
Image is one that retrieves the fully qual- 
ified filename of the last image in a mul- 
tipage document. To save space, I’ve 
not listed the others here. 

The application will store the offset in 
a database somewhere. If the offset is a 
negative value, pass it to the Read mem- 
ber of the LinkedList class, which returns 
a pointer to a fully qualified filename. 
Read assumes you know that the value 
is in the LinkedList. Whether you pass a 
positive or negative number, LinkedList 
will save it as a positive value. 

Open and Close could be put into the 
constructor and destructor. Having sep- 
arate members will allow you to limit 
the number of open files. Close allows 
you to free the two file handles while 
maintaining the internal variable values. 
Open will automatically create a new 
file if one doesn’t already exist. Open is 
called by almost every member func- 
tion just to check if the file handle is 
valid. You can avoid this extra function 
call by checking for the existence of a 
valid file pointer. 


What We’d Do Differently Next Time 

The current design never cleans up 
space released by deleted images. We 
felt that going to optical storage would 
obviate the need to have a delete func- 
tion. However, there were more scan- 
ning errors than we anticipated. The 
linked list and mapper should incorpo- 
rate a single linked-list of deleted records. 
I first saw this in the B-tree code in Al 
Stevens’s C’ Database Development (MIS 
Press, 1987). Both files would have a 
header that would indicate the first avail- 
able slot. That slot would have a point- 
er to the next deleted slot, and so on. 


Summary 

A custom-tailored mapper file can open 
up new avenues for storage. For instance, 
if you have access to a mainframe, you 
could store location information for 9- 
track tape or high-density pack storage. 
You can use any location information 
that you can encode in your customized 
mapper struct. You can store images on 
a LAN, WAN, tape, optical disk, main- 
frame, or jukebox, and this system will 
locate and retrieve each image. 


DDJ 
(Listings begin on page 104.) 


Vote for your favorite feature/article. 
Circle Reader Service No. 6. 
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EMBEDDED SYSTEMS 


Programming the 


Motorola 68332 





Tackling the queued serial peripheral interface 


mong Motorola’s 300-bus mi- 
crocontrollers, the 68332 is 
probably the most applicable 
to embedded-systems program- 
ming. The 68332 offers a slight- 


ly abbreviated 68020 instruction set along & | 


with a few added instructions. The 
68332’s time-processing unit (TPU) al- 
lows 16 digital I/O lines to be employed 


in a variety of timer-event functions. A # 


third functional block of the 68332, the 


Jack J. Woehr 


queued serial module (QSM), processes $ I | 


serial transactions on two channels: The 
first is the serial communications inter- 
face (SCD, which is an on-chip UART; 
the second is the queued serial per- 
ipheral interface (QSPD, a 4-wire syn- 
chronous serial bidirectional transfer 
mechanism. 

Synchronous serial protocols are si- 
multaneous, bidirectional clockings of 
bits between two stations. Synchronous 
serial data communications effect a de- 
sign trade-off between data-transfer 
speed on one hand, and economy on 
the other. While a synchronous serial 
exchange between a CPU and a pe- 
ripheral is slower than parallel bus com- 
munication, the smaller pin package of 
the synchronous serial periphal de- 
mands fewer printed wires and less 
board space. Another advantage of the 
synchronous serial peripheral is that the 
circuit designer, once having become 


Jack is a freelance programmer and con- 
tributing editor to Embedded Systems 
Programming magazine. He can be con- 
tacted at either P.O. Box 51, Golden, CO 
80402, jax@well.sf.ca.us., or by fax at 
303-277-9497. 
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familiar with such a peripheral device, 
is able to employ it in various designs 
without regard to the host microcon- 
troller. In programmer’s parlance, the 
synchronous serial peripheral is more 
portable than the bus peripheral. 
Among the popular synchronous se- 
rial protocols for which off-the-shelf sil- 
icon devices are available are Philips/ 
Signetics’ IC, National Semiconductor's 
Microwire, and Motorola’s SPI. While 
the I7C is attractive because it provides 
synchronous, full-duplex communica- 
tions and determinate arbitration of 
multiple masters using two wires, the 
other two protocols (which require four 
wires and depend upon single-mastering 
via chip selects and station addresses) 
are useful, inexpensive, and available. 


4 Not Just SPI 


The queued serial peripheral interface 


Ly § (QSPI) submodule of the 68332 QSM is 


highly programmable, enough so that it 
can be used not only with the various 
and sometimes divergent implementa- 
tions of Motorola SPI, but also with Na- 
tional Semiconductor Microwire devices. 

In discussing the 68332, I'll refer to 
Vesta Technology’s SBC332, a stand- 
alone, 68332-based, single-board com- 
puter. The SBC332 is a Motorola BCC 
pin-alike/work-alike with socketed 
memory and certain other features in- 
tended to make the SBC332 more gen- 
erally useful than its ancestor, the BCC. 

The SBC332 has been used to control 


an LCD/beeper/keypad (LBK) daugh- 


terboard via SPI, using the QSPI on the 


Vg 332 side and two Harris CDP68HC68P1 
Ye 8-bit SPI parallel ports on the LBK itself. 
~~ If you're a data-sheet junkie and don’t 


have the Harris book handy, note that 
the CDPO8HCO68P1 is a part acquired from 
GE/Intersil and appears in the latter or- 
ganization’s last few annual catalogs also. 

In certain applications we’ve made 
good use of the 93(C)46, a second- 
sourced Microwire EEPROM which of- 
fers 64 16-bit words of readable/writable 
storage with a life cycle ranging from 
100,000 writes per cell to over 400,000 
writes per cell, depending on the man- 
ufacturer’s specification. Larger devices 
ranging up to 11-bit address space that 
are essentially code-compatible with the 
smaller part are available in this family. 

Communication with these two 
parts, the CDP68HCO8P1 and the 9346, 
is the subject of the code examples 
presented here. 
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It’s the best editor for any Windows programming environment. 





Maybe they didn’t notice? COMPUTER . With or without IDE, 

Do you feel like there’s a hole in your programming environment where the editor LANGU ASE ] Codewright fills the void 

should be? You’re not alone. As the major compiler vendors hang more whizzies ponneseper acer Codewright works with your environment or 

and useful tools on their environments, they seem to have lost track of something -- stand-alone as your Super-Integrator. Either 
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the importance of the editor they’re hanging them on! 


Historically, a powerful editor (Codewright, for example) has been the most effective 
productivity tool professional programmers have. We all appreciate the "Visual" 


way, you get a state-of-the-art workbench. Only 
Codewright lets you compare your revisions, 


Pete merge changes, and scan file contents. With 


WINDOWS 





shortcuts, but today’s complex applications are still built largely on hand crafted 100 Codewright, you can check in and check out 

code. That requires the power and flexibility of Codewright. W files from your version control. You get Unix 

Ge eo file support, multi-buffer operations, network 
I'm finding that IDEs don’t pass muster for my large scale projects, WIN AWARD. | support, and project management that leaves 





and their editors lack the sophisticated features I need. Codewright you in control. 


is outrageously good. I plan to use it from now on for all my 





Windows programming. . You owe it to yourself 
Tom Sora PC Jocinigues, Jone /lun Ng Find out why Codewright is the most celebrated editor of the 
Windows era and how it can fill the holes in your development 
[The Visual C++ editor] lacks almost every feature imaginable. environment. We can even arrange for you to evaluate Codewright 
(Incidentally, Borland’s IDE editor isn’t any better) However, I without risk. Or better yet, order Codewright today and be more 


keep Codewright on my Tools menu for heavy-duty editing. productive tomorrow -- guaranteed. 


Bob Chiverton, Microsoft Systems Journal, June 1993 ; is ees, dames “ein dealin alae GO 
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(continued from page 60) 

Queued Serial 

The QSPI queue has 16 entries for com- 
mands and synchronous replies that 
travel on this bidirectional facility. The 
commands are written to command 
RAM, and the replies returned in re- 
ceive RAM. 


In-Circuit Emulators 
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Unparalleled features 

HLL debugger with locals support 
External unit, no plug-in cards !!! 

High speed download (64k in 12 sec) 
Banking support for > 64KB operation 


see the difference - free 2 week trial 


SIGNUM SYSTEMS 


Mountain View, CA / Thousand Oaks, CA. 


(415)903-2220 (805) 371-4608 





CIRCLE NO. 829 ON READER SERVICE CARD 


Compil8 
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Once the desired setup is achieved by 
programming the appropriate QSM reg- 
isters (for instance, by setting up the baud, 
master/slave relationship, appropriate 
clock edge for data latching and desired 
chip-select levels as in the accompanying 
source-code examples), conducting one 
or more QSPI transactions is a matter of: 
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e Writing commands to command RAM. 

e Setting the new queue pointer 
(NEWQP) and end queue pointer 
(ENDQP) to point to the first and last 
command of a series of commands 
which are to be transmitted. This is 
done after establishing whether the 
commands between NEWQP and 
ENDQP should loop or execute in se- 
quence once only by our settings of 
serial peripheral control register 2 
(SPCR2). 

e Sending a “go” message to the QSPI 
by setting the serial peripheral enable 
bit (SPE) high in serial peripheral con- 
trol register 1 (SPCR1). 


The queue can also be used to store 
two or three multiple-message transac- 
tions. When one of these transactions 
is desired, you simply set the new/end 
pointers to the appropriate entries in 
the 16-entry queue and let ’er rip. In 
this way, a number of short transactions 
can be used many times without re- 
programming each transaction every 
time it’s needed. 


The Code 

The source code presented here is writ- 
ten for Vesta Forth Standard Edition 
(VFSE), a fully orthogonal, 32-bit, sub- 
routine-threaded, ROM-resident Forth, 
optimized for generation of embedded- 
control applications. 

LBK332.F (Listing One, page 106) il- 
lustrates the use of the QSPI to control 
the Vesta LBK LCD/beeper/keypad 
board. While notable as a model of set- 
ting up the various registers and acti- 
vating queued operations, once they are 
initialized the LBK’s CD68HC68P1 ports 
are typical SPI protocol parts and re- 
quire no especially neat programming 
tricks, other than appropriate delays for 
the controlled peripherals to react to 
commands. When I wrote the code, it 
wasn’t clear to me why the serial pe- 
ripheral finished flag always seemed to 
come True before the receive RAM that 
contains the response from the ad- 
dressed SPI peripheral becomes valid. 
It turns out that the SPF flag doesn’t self- 
reset; software must do this at the com- 
mencement of every queue launching. 
Well, Pll be! I therefore resorted to long 
loops (see the word LBK332! in the list- 
ing) between the instant QSPI asserts 
that a transaction is finished by setting 
the serial peripheral interface finished 
(SPIF) bit in the serial peripheral status 
register (SPSR) and the time I actually 
read the receive RAM. Sounds silly, but 
it worked at the time. 

QSM332.F (Listing Two page 108) 
provides the generalized constructs for 
programming the registers of the QSM. 
All the registers concerned with QSM 
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(continued from page 68) 

control are defined, along with their rel- 
evant bits. Where multiple-bit mask 
fields appear in the programming mod- 
el, both the field and the shift required 
to move a right-justified mask into the 
proper position for writing to the reg- 
ister are defined. 

Also defined are words to manipulate 
QSM interrupt structure, processor mode 
of access, activity, and status during 
68332 BACKGROUND mode. 

In 9346_332.F (available electronical- 
ly), the requirements for emulating Mi- 
crowire are more demanding. While it 
is easy enough to program data transi- 
tions on the correct clock edge as suit- 
ed to Microwire by setting the CPOL 
and CPHA bits in serial peripheral con- 
trol register 0 (SPCRO), the problem of 
message length is not as tractable. 

The 68332 QSPI is designed for mul- 
tiple transactions of the same data width. 
While that data width is programmable, 
it is difficult to reprogram on the fly, but 
that is precisely what is required to in- 
terface a Microwire device to the QSPI. 

Certain operations upon the 9346 take 
one start bit, a 3-bit command, a 6-bit 
address, and a 16-bit data value. This 
10-bit+16-bit bidirectional data exchange 
isn’t native to QSPI: The bit-width of an 


FREE 
CALL 
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SPI transaction is not part of the com- 
mand RAM entry. Instead, it’s a bit mask 
in SPCRO. Therefore, a transaction must 
be completed before this setting is 
switched from 10-bit to 16-bit transac- 


The 68332 QSPI is 
designed for multiple 
transactions of the 
same data width 


tions (the maximum) for the second por- 
tion of the Microwire message. 

The problem is that when the trans- 
action is suspended after the prelimi- 
nary 10-bit start+ command + address is 
transmitted to the 9346, QSPI lets the 
chip-select for the device go inactive, 
terminating (from the point of view of 
the 9346) the transaction. 

The trick is that the program must ex- 
plicitly assert the chip-select for the de- 
sired device by writing the appropriate 
mask to QPDR prior to activating the 
SPI. If the chip select is asserted ex- 
plicitly, SPI doesn’t de-assert it upon 
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completing the single preliminary 10-bit 
transaction. Then the bit-width field in 
SPCRO can be changed quickly and the 
second portion of the transaction sent 
on its way. The 9346 doesn’t care that 
the serial clocking is thus a little longer 
between the 10th and 11th bit than at 
other times, since transaction clocking 
is the responsibility of the host proces- 
sor. At the termination of the complete 
transaction, the chip-select is explicitly 
de-asserted. 


Conclusion 

“Sixers” who’ve watched in frustration 
as the 68K family has been relegated 
upwards to VME can relax now that Mo- 
torola has finally provided a part suit- 
able for control applications, the bread 
and butter of embedded-systems pro- 
gramming. Just as 68332 on-chip dis- 
crete I/O and TPU help justify the cost 
of the part, 68332 QSPI alleviates, in 
part, the often-difficult task of selecting 
appropriate peripheral devices for a 
68K-based embedded system. 


DDJ 


(Listings begin on page 106.) 
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Sierra Systems undefeated on the 68040. 
Two benchmarks were selected, Dhrystone 2.1 
(the Toy program) and the Sierra Systems 
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world applications. 
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Compilers: GNU 2.0, Intermetrics 8.0, Introl 3.06, Microtec Research 4.24, 
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the PC, except for GNU and Oasys/Green Hills, which were run on the Sun. Running 
the Sierra Systems compiler on both host systems allowed the Sun times to be 
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NETWORKED SYSTEMS — 


Network Access to 


CD-ROMs 


Client/server software for extending CD-ROM 
access across a NetBIOS-based network 


here are two commonly used 

methods of providing network 

access to CD-ROMs. One is to 

use Microsoft's MS-DOS CD- 

ROM Extensions (MSCDEX) or 
equivalent redirector to make the CD- 
ROM appear to be a hard disk, which is 
then mapped across the network. This 
approach works with LAN servers that 
run as MS-DOS applications and do I/O 
with standard INT 21 services to access 
the drive letter instead of bypassing MS- 
DOS. To the client, the CD-ROM drives 
are indistinguishable from other server 
drives. The client, however, cannot com- 
municate with MSCDEX or access its an- 
cillary functions. 

A second approach to sharing CD-ROMs 
is shown in Figure 1. Here MSCDEX 
runs on each client workstation along 
with a pseudo CD-ROM driver that ac- 
cepts normal CD-ROM driver requests 
from MSCDEX. These requests are trans- 
mitted over the network to a pseudo 
redirector on a server, which then sub- 
mits the request to a bona fide CD-ROM 
device driver. The response from the 
CD-ROM is returned via the network to 
the client pseudo driver that, in turn, re- 
sponds to MSCDEX. So long as the client 
pseudo CD-ROM driver responds ap- 
propriately, MSCDEX will be unaware 
that the actual drives are located on a 
remote machine. This is the scheme im- 
plemented by the client/server program 
presented here. 


John and Wuhsiung are members of the 
Mathematical and Information Sciences 
faculty of Sam Houston State University, 
P.O. Box 2206, Huntsville, TX 77341. 
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at implementing a DOS redirector (see 
“A DOS Redirector for SCSI CD-ROM,” 
DDJ, March 1993) to make a CD-ROM 
appear to be a conventional, read-only 
hard disk. Jim wrote his redirector to in- 
terface to his own SCSI device driver. 
MSCDEX is designed for use with drivers 
that have a standard DOS-character de- 
vice interface and respond to an ex- 
tended set of DOS-device driver com- 
mands. Either combination will make 
High Sierra and ISO-9660 CD-ROMs ap- 
pear as read-only hard disks to DOS. 
This article describes a client/server 
software package which extends CD- 
ROM access across a NetBIOS-based 
network. It supports file redirection and 
the ancillary MSCDEX functions as well 








Jim Harper provided an in-depth look 


as digital sound files that are treated as 
data files. Thus, programs such as Desert 
Storm work as they should. Normal CD 
audio is not supported, so some programs 


| run properly but silently. 


The server program was written in Ada. 
It runs in real mode under DOS (or, a 
specific version of DOS under OS/2) and 
takes advantage of Ada’s built-in multi- 
tasking to support concurrent access to 
seven CD-ROMs by up to 32 users. 

The client program is written in 
MASM. It runs under DOS in conjunc- 
tion with MSCDEX. Multiple copies of 
the client can be loaded for simultane- 
Ous access to multiple servers. The client 
can be loaded high with QEMM and can 
be unloaded. Unfortunately, MSCDEX 
loads after the client and therefore can- 
not be unloaded. 


The CD-ROM Device Driver 

CD-ROM device drivers have the usual 
DOS format for device drivers. That is, 
a device header followed by the strat- 
egy and interrupt procedures. 

The device header is an extension of 
the normal character device header; see 
Figure 2. The Attributes field identifies 
the device as a character device sup- 
porting IOCTL and OPEN/CLOSE. 

The extension consists of the three fields 
after the device name: Reserved, Drive- 
Letter, and NumberOfUnits. DriveLetter is 
a read-only field for the driver and both 
it and Reserved should be initialized to 0. 
MSCDEX uses DriveLetter when it as- 
signs the devices supported by the driv- 
er to a drive letter. According to my doc- 
umentation, for drivers which support 
more than one drive, the drive letter will 
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(continued from page 72) 
indicate the first unit and each succes- 
sive unit will be assigned the next-high- 
er driver letter. My observation, how- 
ever, is that MSCDEX puts the last, rather 
than the first, drive letter assigned to this 
driver in the drive-letter field. 

The device driver sets NumberOfUnits 


the driver loads. This is not the same as 
the NumberOfUnits returned to DOS dur- 
ing the INIT call when a device is installed 
from CONFIG.SYS. DOS must always be 
returned a value of 1 for a character de- 
vice in the INIT field. The number of units 
field in the device header, however, is 
read and used by MSCDEX and never 


A program requests the services of a 
device driver by sending the driver a 
request header message containing a 
command code and related data. The 
request is passed to the driver in two 
calls. The first call is to the driver strat- 
egy routine with the ES:BX registers 
pointing to the request header. The strat- 


to the number of devices attached when | seen by DOS. 


CD-NET MSCDEX 





CD-CLIENT 


CD-SERVER 
Figure 1: Networked CD-ROMs. 
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egy routine is expected to save the 
pointer in local storage for use by the 
interrupt routine when it processes the 
request. Immediately following the call 
to the strategy routine a second call is 
made to the interrupt routine, which re- 

trieves the request and processes it. 
DOS rigidly adheres to this strategy/ 
interrupt calling sequence; MSCDEX 
does not. Instead, MSCDEX assumes it 
has exclusive control of the driver. It 
uses a DOS call to open the device 
(continued on page 78) 
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label word 
dword ~{ 
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word Interrupt 
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DeviceHeader 
NextDriver 
Attributes 


DeviceName 
Reserved word 
DriveLetter byte 
NumberOfUnits byte 





Figure 2: CD-ROM driver header. 
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Changing Windows™ Applications Into OS/2® Applications Is 


A Neat Trick Done With Mirrors 


\ | icrografx Mirrors™ can help you work 

magic. You can reach over a million new 
users for the price of an inexpensive tool kit. With 
Mirrors, you can maintain an application for two 
operating systems with 
a single set of source. 
This means you aren't 
forced to choose 
between operating 
systems, and you won't 
get bogged down in 
version control prob- 
lems and divided 
development efforts. 

Get the advan- 
tages of OS/2: great 
performance, access to 
a true multi-tasking 
operating system, 32-bit architecture, a more stable 
platform, integration with other OS/2 applications, 
and a clear migration path — not to mention the 
advantage of a million new customers. 

How does it work? It’s simple. Mirrors 


emulates Windows. When your application, 





running under OS/2, calls a Windows function, 
Mirrors intercepts the call. Mirrors then imple- 
ments it using functions within the OS/2 system 
DLLs. Mirrors transforms data returned by OS/2 
and passes it back in a 
form that Windows 
applications under- 
stand. Your applica- 
tion may never know 
that it’s not running 
under Windows. 

What do you 
need to do to make 
this happen? First, run 
Micrografx’s conver- 
sion utilities on your 
application’s resources, 
then re-link with the 
Mirrors DLL. That’s it. Using Mirrors, you may 
not even need to recompile. Micrografx developed 
Mirrors. That means this tool kit was written by 
Windows developers for Windows developers. 
Mirrors is fast and inexpensive. 


Look into it! 





To purchase your copy of Mirrors today, call (214) 994-6566. 
To learn more about how this trick is done, call Micrografx Technical Support for Mirrors at (214) 994-6659. 


‘ Mirrors is a 32-bit DLL for increased performance ‘32-bit Mirrors DLL provides support ‘for 16-bit applications 
: Non-debug and debug versions of Mirrors DLL provide handle validation and error reporting 
‘Automated conversion of Help, bitmaps, cursors, and tcons * Includes DOS and OS/2 host independent file /O libraries 
‘Interrupt 21 directly supported with no need to modify ASM files: DOS3CALL interrupt support 
‘ Dynamic Data Exchange support with native PM applications « Mirrors also supports Chipboard data sharing 
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Micrografx, Inc., 1303 Arapaho, Richardson, TX 75081. Copyright © 1992, Micrografx, Inc. All rights reserved. Micrografx is a registered trademark of Micrografx, Inc. Windows is a trademark of Microsoft. 
OS/2 is a registered trademark of IBM Corporation. All other products are trademarks or registered trademarks of their respective owners. Mirrors is a trademark of Micrografx, Inc. Micrografx Mirrors is not 
affiliated with Softklone Distributing Corporation or Softklone's MIRROR data communications products. 
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ven a free memory manager may not be a bargain—especially if i 
can't give you all the memory you need. 


Introducing QEMM7 
The Memory Manager Worth Paying For 


The newest version of the Quarterdeck Expanded Memory Manager 
(QEMM), version 7 once again is extremely innovative in using the 
critical area between 640K and 1024K. It finds space for more TSRs and 
drivers in this area than anyone thought possible. It optimizes this area, 
taking into account the many drivers that need more memory at start- 
up than when running; instantly calculating millions of possible 
memory configurations to find still more memory for your programs t¢ 
use. And it treats the rest of memory as a giant pool to instantly fulfill 
the needs of all of your programs—whether they use extended or 
expanded memory. Whether your PC has 1 megabyte or 16, you can 
benefit from new QEMM 7 


Instant Riches 


What does more memory mean in a practical sense? It means that you 
DOS and MS Windows programs run faster, 
smoother and more reliably. It means you can 
continue to add valuable utilities, drivers, 
TSRs and new capabilities to your PC. 
Whether it workhorse drivers like LAN util- \ 
ities and fax drivers; productivity-enhancers 
like disk caches and disk compressors; or fun and 
exciting capabilities like sound boards, CD ROM drivers, graphics 
tablets, etc. The better your memory is managed, the more versatility 
and flexibility your PC has. QEMM 7 lets you have it all without fear o 
‘out of memory’ messages or crashes. 









The key to Stealth 1S its use of a There’s lots more to QEMM 7: 
64K reserved area above 640K called + Tuned for MS Windows 
the page frame. Besides being used by | * Newability to use Vidram inside 





" . MS Windows 
FEZ Stealth, the page frame is used by * DPMI Host 
OPES EIVEVEVE ES IEEE ©) EEFFEFFAE Lotus 1-2-3 12.x for larger spread- oe 





- sheets and WordPerfect 5.x for larger _ | * Laptop suspend/resume support 
¢ PS/2 micro channel adapters 


¢ Compaq support 
¢ Fine tuning tools for power users 


SESE WEA SE EEL LES eS ene e eae RSS fee ere are TEm 4 
100K =—-200K 300K 400K 500K 600K documents, DESQview for multitask- 


tested DOS 6 with and without MemMaker and with QEMM 6 and our new QEMM 7 ing, Novell Netware, IBM LAN Server 


s away from all of them. See details of test conditions listed below. 
: and DECnet for reducing the network | « 32-bit architecture for speed 


DOS 6 Giveth; DOS 6 Taketh Away driver memory footprint plus games | *Ehaned compat npr 
> best feature of new DOS 6 is the stable of utilities it includes. like Wing Commander, Car and Driver, | of users: 


: . i Detects adapter RAM and ROM 
uble is, they all eat up memory. DoubleSpace file compression needs Ultima Underworld Il, Wolfenstein ang and bus-mastering hard drive 









<, Vsafe anti-virus needs 7-45K, Smartdrv disk cache needs 28K and fies fast action. na sacrifice all ee lesen 
n Undelete takes 10-14K as a resident program. Using this when you turn ane os frame sale access into 
crosoft’s free memory utility, MemMaker, you could Pa Tt Pc/comPUTING (which 0 . TEMOTY | Supports Shadow RAM 
ily end up with a net loss of available ‘conventional’ managers do to maXxi- 

mize available 


mory in DOS 6. INF } ' Gi 4 BEST PC PRODUCTS 
New QEMM 7 takes the best of the new DOS 6 : 
tures into account, finding ways to give you more 
> memory for your program while taking full advan- 
2 of DOS 6. One new QEMM 7 feature, DOS-Up 
ves the DOS 6 kernel, its data and resources to 
mory above 640K (this feature also works withDOS Jp | 
) en 770K. rons new QEMM 7 feature _ are a el ea | eanparee ome 
alth DoubleSpace, frees 40K of the memory | Dee weal the same configuration, after 
Iresses used by DoubleSpace and makes them avail- Prior versions of QEMM won just about using MemMaker) 


memory above 640K). Its this use of the page frame by 
Stealth that lets you set up your PC with a mouse, CD 
ROM, sound board, a network such as Novell 
NetWare, reserve 8-24K of extra memory for optimal 
MS Windows performance, use all of DOS 68 


memory-hungry utilities and still have more than 



















2 for other drivers and TSRs. Both features ensure hee dia a Ensier to use for Novices, 

t the all-important memory below 640K is free for manager 5 years straight. More Power for Experts; 

ir programs. And QEMM 78 seemingly small feature y 
supporting DOS 6s multiple configurations gives you the flexibility More Memor y for Ever yone 

1 ease of setup that you expect (MemMaker doesn't work well with Our seventh-generation thoroughbred QEMM has improved ease-of- 
s important DOS 6 feature) That's why it makes more sense than use, with Express Install and Help features. And for power users, 

1 to put your money on the best memory managet—QEMM. Advanced Install and editable parameters and troubleshooting hints. 

Page Frame: the Key fo Your Future And QEMM 7 comes with Manifest, the award-winning memory 

eres been a lot of talk about our patent-pending Stealth technology. analyzer—enhanced for more flexibility—from Pentium testing to lap- 
lous talk, mostly. Because nobody else can touch its performance. top battery reporting; network analysis to editable configuration files. 
ir Stealth ROM feature, pioneered in QEMM 6, frees 48-II5K of ROM The new and ever more exciting capabilities coming to your PC 
Jresses for use by TSRs and drivers. Our Stealth DoubleSpace will all compete for memory with your favorite applications, TSRs and 
ture, described above, frees another 40K. And as you might imagine, drivers. And that makes QEMM 7 the front runner in your efforts to get 
>reS more to come. get the best performance out of your PC today—and tomorrow. 





Yuarterdeck Office Systems, 150 Pico Boulevard, Santa Monica, CA 90405 (310) 392-9851 Fax (310) 314-4219 
Juarterdeck International Ltd, B..M. House, Crofton Terrace, Dun Laoghaire Co. Dublin, Ireland Tel. (353) (1) 284-1444 Fax: (353) (1) 284-4380 
QEMM Users: upgrades are available from dealers. 
You can also buy direct from Quarterdeck. Call (800) 354-3222 ext. 1D7 and ask about our special Game Pack offer with your upgrade! 


How “eS the chart numbers CPU—486/33 ALR Power/ business VEISA machine equipped with 16 ne of RAM and running MS-DOS 6. Comparisons were done using the =e memory managers: QEMM 7, QEMM 6.02, MS-DOS 6 MemMaker. In addition to the driver (or drivers) 
required by each memory manager, the following drivers, DOS resources and programs were loaded for all comparisons: in the CONFIG.SYS file: R.EXE, DOs-HIGH, FILES=20, BUFFERS=10, STACKS=0.0, MVSOUND SYS, SNDBK12SYS, SLCD.SYS, DOS SHELL=statement, in the 
AUTOEXEC.BAT file: VEAFE MSCDEX, UNDELETE, LSL.COM, NE2000.COM, IPXODI.COM, NETX OR EMSNETX, MOUSE.COM, SMARTDRV.COM, PRTSCCAP.COM. 

©1993 Quarterdeck Office Systems. Trademarks are property of their respective owners. 
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(continued from page 74) 

driver and gets the driver’s header ad- 
dress through an IOCTL input request. 
The device is then closed to release the 
handle. 

MSCDEX uses the device-header ad- 
dress to locate the driver’s interrupt-rou- 
tine entry point. Subsequent calls are 
directed to the interrupt routine and as- 
sume the request-header address was 
stored on the original open call. Con- 
sequently, calls to the driver which by- 
pass MSCDEX change the stored re- 
quest-header address and invalidate this 
assumption. The system usually crash- 
es on the next MSCDEX call. Hence, 
communications with the driver should 
use the MSCDEX-supported send-device- 
driver request rather than calling the 
driver directly. 

In the usual DOS sequence that I’ve 
observed, the call to the interrupt rou- 
tine immediately follows the call to the 
strategy routine and the ES:BX register 
values are not changed. While MSCDEX 
bypasses the strategy call, it does point 
ES:BX at the request header when it calls 
the interrupt routine. Thus, the strategy 
routine can be reduced to a Return state- 
ment and the request-header address 
stored upon entry to the interrupt rou- 
tine. This is nonstandard but it will al- 
low direct calls to the driver without fa- 
tal conflicts with MSCDEX. 

Another common problem is the fail- 
ure of many programs to fill in the re- 
quest-header information correctly. Nu- 
merous programs ao not ory 


INIT 
media onieek © _ 
build aa _ De _ 





_ np howelt 
_ input status 
_ input flush 
/ output — CC. 
output with verity _ 
output status 
output flush © : 
IOCTL OUTPUT. : 
DEVICEQPEN._—s_—i 
DEVICECLOSE _ 
removable media 
output until busy — 
READ LONG 
_ reserved 
read long protatel 


~OONOORWN+O 


play audio 

_wiitefong : 
write long verify 
resume audio 





Table 1: DOS driver commands 
(required commands are in upper 
case, optional commands in lower 
case, inapplicable commands in 
italics). 
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CD-ROM 


specify the control-block length for 
IOCTL input and output and require a 
“lookup” fix in the client. Guinness Disk 
of Records (a CD-ROM version of the 
standard Guinness Book of Records, 
available from Compton’s New Media) 
doesn’t even get the request-header 
length correct on the IOCTL output 
commands that control the analog au- 
dio settings. 


CD-ROM device 
drivers have the 
usual DOS format 
for device drivers 





In addition to the fields added to the 
device header, the minimal CD-ROM 
driver must support five of the standard 
DOS-driver commands and two of the ex- 
tended commands for locating and read- 
ing CD-ROM sectors. These commands 
are shown in Table 1, where codes 128 
and higher are unique to CD-ROMs. 


The Pseudo CD-ROM Driver 

On a client workstation, the pseudo CD- 
ROM driver replaces the CD-ROM de- 
vice driver supplied with the controller 
card, as in Figure 1. It installs from the 
command line like a TSR rather than 
being loaded from CONFIG.SYS. 

The executable file consists of ap- 
proximately 3K of code and is divided 
into two parts: a resident part that im- 
plements the driver functions, and a 
transient part that loads/unloads and ini- 
tializes the resident part and is then dis- 
carded. 

During installation, command-line pa- 
rameters, if present, are parsed and 
used to replace default values for the 
driver name, the CD-ROM server name, 
and/or the client’s net name. Installa- 
tion fails if the net name cannot be 
added to the NetBIOS name table for 
any reason except a duplicate name in 
the table. This exception allows the 
driver to be installed more than once 
using the same net name for simulta- 
neous access to more than one CD- 
ROM server. A different driver name 
must be used for each instance or the 
second installation will hide the first in 
the driver chain. 

The resident part of the client driver 
implements the driver functions that sim- 
ulate the actions of a true CD-ROM driv- 
er. It is essentially a large CASE state- 
ment which switches on the request- 
header command code. All required CD- 
ROM driver functions and the optional 


READ LONG PREFETCH function are 
supported. The CLOSE command is pro- 
cessed locally. The others transfer the 
request to the CD-ROM server through 
NetBIOS calls implemented in an in- 
clude file. 

When a device driver is loaded from 
CONFIG.SYS, DOS calls INIT as part of 
the installation procedure. When the 
client driver is loaded as a TSR, as it is 
done here, the normal initialization is 
done by the transient loader. The first 
(and only) call that DOS makes to the 
driver is when MSCDEX opens it to lo- 
cate the device header. Thus, INIT isn’t 
needed, so it’s omitted. The OPEN func- 
tion establishes a connection with the 
server and uses a dummy INIT call to 
the server to obtain the number of CD- 
ROMs available. This number is put in 
the client driver header for later use by 
MSCDEX, and DOS is simply told that 
the driver has been opened. 

The network connection is simple. 
The request header is sent to the serv- 
er first, followed by any accompanying 
data. After the server has processed the 
request, the request header is returned 
to the client first, followed by the data. 
Dynamically allocated buffers are used 
in the server. Only cooked-data read 
mode is supported. The NetBIOS max- 
imum message size (64K-1) restricts 
READ LONG requests to 31 sectors in 
a single transfer. When a request ex- 
ceeds this, the client makes multiple re- 
quests to the server. 


The Server Side 

The server is implemented as a group 
of non-preemptive tasks, as shown in 
Figure 1. The SCHEDULER handles new 
calls and assigns a separate, available 
SESSION to each client. NET handles 
the interaction between NETBIOS and 
the SESSIONs, and CD is the interface 
task between the SESSIONs and the CD- 
ROM driver. The net names of the at- 
tached clients are displayed by the CON- 
SOLE task, which is not shown in the 
figure. The main program, SERVER, lo- 
cates the CD-ROM driver and statically 
activates all the tasks. After initialization, 
the session tasks call the scheduler and 
are queued to be assigned to client calls 
in a FIFO basis. The scheduler in turn 
makes a listen call to NetBIOS. When a 
client call is received, it is passed on to 
the session task. This is repeated until 
all the sessions have been assigned 
clients. When the scheduler queue is 
empty, there will not be an active LIS- 
TEN and the server will not respond to 
new client calls. The session tasks re- 
ceive the request header and any asso- 
ciated data from the client via NetBIOS 
packets and pass it on to the CD-ROM 
task. The CD-ROM’s response is in turn 
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encoded in NetBIOS packets and re- 
turned to the client. When a session ter- 
minates, the session requeues itself with 
the scheduler. 

Non-preemptive tasking is used. To 
ensure the needed cooperation, the calls 
to NetBIOS are all nonblocking calls and 
pauses are inserted at appropriate points 
in the various tasks. 


Real World Problems 

Most of the server is written in the usu- 
al, straightforward style characteristic 
of Ada. However, Meridian Software’s 
implementation (the system we used) 
of certain data structures makes inter- 
facing to externally generated data 
streams difficult. If you remain totally 
within an environment of “correct” Ada 
programs, there’s no problem. Unfor- 
tunately, the real world seldom affords 
such luxury. 

The first problem relates to alignment 
holes. Alignment holes occur when 
space is inserted between the compo- 
nents of a record to satisfy alignment 
requirements of the individual compo- 
nents. For instance, a far pointer which 
uses four bytes of storage may have an 
alignment requirement that its storage 
address be divisible by four. When an 
object of such a type is included in a 
record type it is aligned at an offset di- 
visible by four with filler bytes inserted 
as needed to effect the alignment. This 
makes it difficult to match externally de- 
fined records which ignore the align- 
ment constraints. 

To work around the alignment-hole 
problem, first you declare two new nu- 
meric data types: Byte (range 0..255) 
and Word (range 0..65535). A third type 
Bytes is then declared to be an uncon- 
strained Byte array. Type Bytes can then 
be used to declare multibyte fields with- 
out introducing alignment holes. The 
declaration of Wto be a 2-byte subtype 
of Bytesand DW to be a 4-byte subtype 
accommodates the two most common 
multibyte fields encountered in exter- 
nally generated records. Typecasting 
functions convert objects of type W 
to/from type Word and objects of type 
DW to/from type system.address. 
Long_Integers are also declared to sim- 
plify the handling of these object types. 
These declarations are in the TYPES 
package shown in Listing One (page 
113). Their use in record descriptions is 
shown in the Drivers package in List- 
ing Two (page 113). Other required files 
are provided electronically; see “Avail- 
ability,” page 5. 

The second problem relates to dis- 
criminant records. Discriminant records 
are used when a record may have any 
one of several different descriptions, de- 
pending upon the value in a specified 
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Intellicon-NT 960 


a RISC based multi-port 
I/O subsystem for 
serial communications 


Performance of 512 serial ports with 4 
* An on-board Intel i960 host adapters in a system 
32 bit RISC processor x The ACM/ 16 module 
off-loads the serial I/O has both RJ45 and 
task from the main CPU DB25 connectors 
* Offers up to 2MB of * Offers optional on-board 
on-board dynamic RAM realtime clock and optional 
for data storage on-board battery backup 
* Offers up to 256KB of for the dual-ported RAM 
on-board dual-ported * Supports 80286, 80386 
RAM and 512KB Flash and 80486 AT bus 
EEPROM for data architecture 
storage and custom Software Flexibility 
application programs * Development tools 
* RISC-like quad UARTS available for custom 
with 24 bytes of FIFO development 
per channel provide high 4 Software support for 
speed data communi- UNIX, XENIX, QNX, 
cations up to IISK baud DOS 
ss a ae Reliabilit 
Hardware Flexibility gince 1985 Conte Tech's 
* The Intellicon-NT960 products have become 
subsystem includes a known for their unsurpassed 
NT960 host adapter, quality and reliability. This 
the ACM/ 16 external tradition of providing flexible 
ane eae Pe cost effective solutions is based 
module, software drivers ; Sed 
Call us today at telephone 519/836 /1291 or and manuals ae reac ear Se 
ae ; esign and manufacture 
facsimile 519/836 /4878 to find out more about * Provides 16 to 128 asyn- — o¢ communication hard- 
the Intellicon-NT960 and other Connect Tech chronous serial ports ware and software. At 
communication products from one PC slot Connect Tech we meet 
* Accommodates a total your objectives — by design. 


Connect Tech Inc. 727 Speedvale Ave. W. Tel: 519-836-1291 


‘Meeting your objectives ..by design’ Guelph, ON N1K 1E6 Fax: 519-836-4878 
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THERE IS NO SUCH 
THING AS A FREE MAKE! 


Why pay for a Make utility when one comes free with your compiler? Be- 
cause the moment you start using it you start paying for it. You pay with your 
time, effort and frustration in trying to keep your software projects up-to-date. 


Opus Make excels where your Make falters. For large projects and interfacing 
to version control systems, for transparent handling of your Microsoft and 
Borland makefiles, for PolyMake makefile processing at twice the speed for half 
the price, for exceptional technical support at no additional charge, Opus Make 
version 6.0 is the only economical choice. 


Your time isn't free. Neither is your sanity. Find out why Andrew Binstock says 
"Opus Make is the most compelling reason for not using the make 
utilities bundled with today's compilers." 





Street 
: a nis) 664-790} ; ax: G 
ftware, s rl E 
ae ‘ar’ information 


Opus Make and OPUS MKMF are trademarks of OPUS Software, Inc. All other tradmarks are owned by their respective companies. 
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field called the discriminant. (A strong- 
ly typed version of Cobol’s redefine fa- 
cility.) The restriction that the discrimi- 
nant field must be the first component 
of the record imposed by some Ada im- 
plementations, can often be worked 
around easily through judicious type 
declarations. Meridian Ada introduces a 
further complication for discriminant 
records whose discriminant may change 
during the execution of the program by 
preceding the discriminant with a con- 
strained flag byte. This flag will have a 
value of 0 unless the record object is 
constrained. 

A discriminant record is used for the 
internal representation of the external- 
ly generated device-driver request head- 
er. The command code is the discrimi- 
nant that determines the variant-record 
description. The external form of the re- 
quest header is treated as a packet of 
type bytes (that is, a byte array). When 
the packet arrives from the client via 
NetBIOS, the command code and all 
subsequent bytes of the packet are treat- 
ed as a byte slice and are shifted right 
one byte in the array. The third byte, 
formerly the command-code byte, is ze- 
roed and becomes the constrained-flag 
byte when an unchecked_conversion is 
used to typecast the packet as a request 
header; see Figure 3. 

The request header must be convert- 
ed back to a packet before being re- 
turned to the client via NetBIOS. Simi- 
larly, when the request header is sent 
on to the CD-ROM, it is first converted 
to a packet before it is sent, and back 
to a request header when it is returned. 
Fortunately, request headers are only 
about 30 bytes in length and there is 
not a great deal of overhead associated 
with the conversion. 






Request Header 


(external) 


(internal) 


a ~~--t---~ 


Request Packet 


byte slice shift 
Request Packet 


unchecked conversion 


Request Header 


Figure 3: Mapping the request header (a = length, b = sub unit, 


Putting It All Together 

The client was assembled using MASM 
6.0b, and the server was compiled and 
linked using Meridian Software’s Ada 
2806 Version 4.1.4. The compiler switch, 
-K, was used to retain the internal form 
information needed for optimization in 
the link step and the switch, -/s, used 
to turn off runtime checks. The latter 
improves performance significantly. 

The link parameters, -G -s 27500 -m 
38000, were used to invoke global op- 
timization and to increase the tasking 
stack and main-program stack space, re- 
spectively. 

The server must be started before 
MSCDEX is started on the client work- 
station but after NetBIOS and the CD- 
ROM driver are loaded on the server 
machine. The CD-ROM driver should 
be installed with the device name 
CDOO1 (for example, use the command- 
line parameter /d:CDOO1). When the 
server starts, it attaches to CD001 and 
installs itself on the network using the 
net name SHSU-CD-SERVER. There are 
no command-line parameters and the 
server will have to be recompiled to 
change either the server name or the 
driver name. 


Mapping the Request Header 

The client program, CDNET, can be 
loaded at any time after NetBIOS is start- 
ed on the client machine. A list of the 
command-line parameters supported is 
displayed if CDNET is started with the 
/? switch. Normally, at least the /c: 
switch will be needed to assign the 
workstation a unique net name. When 
CDNET is loaded, it installs itself and 
validates the client name. This takes a 
few seconds while the name is broad- 
cast. The client software will not load if 


c = constrained flag, d = command, e = status). 
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the client name is already in use on the 
network. The client does not attempt to 
establish a session with the server until 
MSCDEX is loaded. 

Assuming NetBIOS is installed, a typ- 
ical sequence to load CDNET and 
MSCDEX might look something like this 
(case is not important): 


CDNET /c:Monique 
MSCDEX /d:CD-NET 


Additional drivers, either local or net- 
work, can be included using the /d: 
switch on the MSCDEX command line. 
Prior to loading MSCDEX, CDNET can 
be unloaded with the /U switch. Un- 
fortunately, MSCDEX is not unloadable, 
and it is best to not unload CDNET af- 
ter MSCDEX has been loaded. 

Both the client and the server have 
been tested on stand-alone, DOS-based 
machines and in specific DOS sessions 
under OS/2 2.0 using Novell’s NetBIOS. 
However, David Schwaderer’s C Pro- 
grammer’s Guide to NetBIOS, IPX, and 
SPX (Sams, 1992), based upon IBM’s 
NetBIOS implementation, was the 
source book for coding both the Ada 
and MASM NetBIOS interfaces. Thus, 
the programs should run with any Net- 
BIOS implementation that supports the 
5Ch interrupt. 

The server is configured to handle 
32 simultaneous users. To do so, how- 
ever, NetBIOS must be configured to 
handle at least 32 sessions and 32 out- 
standing commands. Novell’s NetBIOS 
defaults to handling a maximum of 12 
outstanding commands and thus must 
be configured to handle additional com- 
mands. The test servers were configured 
by placing the commands NETBIOS 
COMMANDS=32 and NETBIOS SES- 
SIONS=32 in the NET.CFG file. The 
commands are holdover SHELL com- 
mands and should be left-justified. If the 
commands are placed at the end of the 
file, make certain that the last line is ter- 
minated with a return. 

NetBIOS configuration commands 
written in the newer NET.CFG format 
are shown in some books written about 
NetWare. Perhaps they will work for 
you. NetBIOS displays the configuration 
information in its installation message 
(that is, if it's configured for 32 com- 
mands, it will say so). 


DDJ 
(Listings begin on page 113.) 
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t first glance, people working 

in fields such as geology, civ- 

il engineering, aviation, tele- 

communications, sales, real es- 

tate, and insurance appear to 
have little in common. Nonetheless, they 
do share the need to manipulate geo- 
graphical data, then integrate that data 
with electronic maps. 

Conventional mapping software such 
as MapInfo meets some of their needs 
and, for small geographical areas, maps 
can be added to AutoCAD drawings. Nei- 
ther approach, however, is flexible 
enough for you to customize maps to in- 
clude highly-detailed information or to 
integrate maps with other applications. 

What’s really needed is a mapping 
engine that provides a programmer’s 
toolkit for combining mapping functions 
with traditional database or spreadsheet 
data. TerraLogics’ TerraView is a tool- 
kit that does just that by providing a li- 
brary of C function calls for displaying 
and manipulating maps. The library 
works with several different UNIX plat- 
forms (VAX/VMS, ULTRIX, SCO, and X 
Window), Macintosh, Microsoft Win- 
dows, and text environments such as 
DOS (for which it provides its own ba- 
sic windowing systems). In addition to 
C, the library functions can be called 
from Basic, Fortran, Pascal, and Cobol. 


Putting TerraView to Use 

To examine TerraView, I collected in- 
formation on manufacturing facilities 
in Southern New Hampshire. This is 


Peter is an assistant professor of com- 


puter science and mathematics at Rivi- 
er College in Nashua, New Hampshire. 
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Integrating Desktop 


Mapping with 


Geographic Data 


| A programmer's toolkit for 


geographical information systems 


Peter D. Varhol 


typical of a database maintained by a 
traffic engineer who’s looking at em- 
ployers to determine rush-hour traffic 
patterns, or who’s looking for new man- 
ufacturing facility sites. 

My project involved displaying facil- 
ity locations and identifications on a 
TerraView map of the area (TerraLog- 
ics provides street-level maps) as shown 
in Figure 1. This required getting data 
to a TerraView application, bringing up 
the appropriate map, and displaying 
the symbols in the proper locations. 
Since TerraView doesn’t include data 
management or full-fledged user inter- 
face layout capabilities, it’s necessary 


| File Edit Help 


to either build them in by hand (a full 
development effort), or to make use of 
already-existing database development 
environments. I opted for the latter. 

I chose Microsoft Access as the target 
platform for the database portion of the 
application because of its powerful tools 
for passing data to external functions 
and applications. To interact with a 
TerraView mapping application from 
Access, I could either compile my 
TerraView application as a DLL and link 
it to my Access application through the 
Call statement, or create a stand-alone 
TerraView application and call it from 
Access using either the RunApp or Shell 





Figure 1: Map from the sample TerraView application. 
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(continued from page 84) 
instructions; see Figure 2. 

Because in the future, I hope to build 
DDE capabilities into the TerraView ap- 
plication, I decided to take the RunApp 
approach. While the TerraView library 
doesn’t specifically support DDE, the li- 
brary is a regular Windows application, 
and the DDE support can be coded 
within the C-based application envi- 
ronment. For the time being, I decided 
to interact the old fashioned way—by 
writing a file out to disk and calling my 
TerraView application directly from Ac- 
cess. I was able to add DDE support by 
#include-ing DDE.H, which comes with 
Borland’s Turbo C++ 3.1. (Turbo C++ 
had no problems compiling the Terra- 
view shell as is.) 


Preparing the Database Application 
in Access 
I began by creating Access database ta- 
bles representing the company name 
and its location. While I had additional 
information (company CEO and prima- 
ry products, which I included in other 
tables), it was name and location data 
I was going to plot on the map. 

Because plotting by address involves 
a layer of complexity I hoped to avoid, 
I represented company locations using 
approximate latitudes and longitudes 
obtained manually from standard U.S. 
Geographical Service topographic maps 
rather than by street addresses. Plotting 
by street addresses makes it necessary 
to query the map to determine the range 
of addresses along a street, then match 
the known address to an approximate 
location on the map. The amount of 
code I’d have to write would be sub- 
stantial. So that I might be able to plot 
with street addresses at a later time, I 
included street address and latitude/lon- 
gitude in the database table. I consid- 
ered writing my own algorithm to per- 
form the conversion in Access, but 
without using the map I couldn’t think 
of an appropriate computational ap- 
proach. 

I created Access input screens so that 
a user could easily enter, modify, and 
delete members of the database. One 
button I included in my Access user in- 
terface initiated the mapping sequence. 
The code behind this button created a 
text file, wrote out the company name 
and its location to the file, and called 
my TerraView application. This se- 
quence was little more than a few lines 
of code in the Access programming lan- 
guage. Once the Access application was 
laid out, I turned to TerraView. 


Inside TerraView 
Creating a TerraView application is like 
creating any other Windows applica- 


86 


tion. The WinMain function provides 
the basic window, processes the com- 
mand-line arguments, and provides the 
event loop. TerraLogics includes a sim- 
ple WinMain shell with the package, 
which I used as the basis of my own 
application. 

While most of the other windowing 
routines come from TerraView, the ac- 


I represented 
company locations 
using approximate 

latitudes and 
longitudes obtained 

from standard U.S. 
Geographical Service 
topographic maps 





tual application (see Listing One, page 
114) is a sometimes confusing mixture 
of Windows and TerraView calls to drive 
the mapping functionality. Envision Ter- 
raView as a set of library functions. 
These functions can do things such as 
open windows, display maps, place lo- 
cations (either latitude/longitude or 
street addresses) on the maps, and in- 
corporate text information into the place 
locations. TerraView does all this (and 
more) from within the Windows appli- 
cation that you provide. 





After setting up the appropriate Win- 
dows routines and interpreting the com- 
mand line, I started the mapping portion 
of the application by initializing a win- 
dow and bringing up a blank map in it. 
Then I loaded a map. This can be done 
in several ways. The WinMain function 
includes an argv call to read from the 
command line, so a map can be loaded 
automatically at program launch. Alter- 
nately, the shell provided by TerraLog- 
ics displays a simple command line in 
the empty TerraView window, which 
prompts the user to load a map file. 

Another, more elegant, approach is 
to create a Windows dialog box within 
the TerraView shell that lets the user se- 
lect a mapping file from the dialog file 
list. Even with no experience in doing 
so, there’s enough sample code in Tur- 
bo C++ that adding a Select File dialog 
only takes a few minutes. This is both 
a better looking and easier way of 
prompting the user for a map. 

However, since the mapping appli- 
cation was to be opened from an Ac- 
cess application, I supplied the name of 
the map from Access, and placed it into 
the Call statement as an argument to 
the map. Given a more robust database 
application, it’s possible to set up a di- 
alog box to let the user select the ap- 
propriate map, or even to have the ap- 
plication itself choose the proper map, 
based on the locations included in the 
data to be mapped. 

Maps are loaded as overlays onto the 
blank map set up with the window. It’s 
possible to load several different maps 
into the same window using overlays, 
but the most common use of the over- 
lay is to add features to a base map. 





Figure 2: Calling the TerraView application from Access using the RunApp macro. 
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(continued from page 80) 

These features may include highways, 
railroads, natural features, or structures 
such as buildings or power lines. I used 
an overlay to add company locations to 
the map. It’s also possible to include 
code so that the user can control the 
addition, deletion, or layering of over- 
lays from a pull-down menu. 


stat 
stat 


The TerraView application reads the 
data file, using a simple fopen and scanf, 
and loads the data into a structure in- 
side the application. Next, the TerraView 
calls in Example 1 place the appropri- 
ate symbol and accompanying infor- 
mation onto a map overlay, which is 
then placed on the display. Like any 
Windows application, the menu struc- 


TvBeginFeature(ovl_sym, @, @, name, id); 
TvInsertSymbol(ovl_sym, symbol, 


1, peint): 


stat = TvEndFeature(ovl_sym) ; 


TvRefresh(map) ; 





Example 1: TerraView calls to place symbols onto map overlay. 


GLENCO MNES Ay NC INC COM 


Buffalo Grove 
Illinois USA 


YY Printer J 





tures are set up in the application re- 
source (.RC) file. The menu operations 
are structured in the normal Windows 
fashion in C, usually with a switch state- 
ment containing calls to the appropri- 
ate functions. The functions are usual- 
ly TerraView calls, although they can 
also be interspersed with regular Win- 
dows calls. 

The final step was to use TerraLog- 
ics’ IconEdit utility to create a simple tri- 
angle icon to represent the location of 
the companies on the map. IconEdit is 
a simple pixel paint application that en- 
ables you to create custom graphics to 
display on a map overlay. Presumably 
the bitmap painting capability in Win- 
dows Paintbrush can also be used to 
create icons, although I wasn’t able to 
load a .BMP file into IconEdit. 


Beyond Simple Mapping Applications 
I’ve already discovered enhancements 
to add to the mapping application. In 
addition to other ways of calling a map- 
ping application and getting data into 
the application, you can scale and ro- 
tate maps, select and manipulate spe- 
cific street segments, inquire about spe- 
cific map features, and scroll a map. 

For those of you who have used Max- 
is’ SimCity, it is also possible (though 
quite ambitious) to use TerraView to 
create a city or geographical region sim- 
ulation along these same lines. A Ter- 
raView application can be combined 
with a discrete-event simulator to in- 
clude models of automobile traffic for 
examining traffic congestion. A city or 
regional planner could use such an ap- 
plication to study the effects of new de- 
velopment on traffic, or to examine the 
best locations for freeways or public 
transportation. 

The best way to implement many of 
these enhancements would be via DDE. 
It would be nice to have a TerraView 
library that brings the tedious work of 
DDE to a higher level, to make it more 
convenient to the programmer. After all, 
this will undoubtedly be an ideal way 
to create a generic mapping application 
that could display geographic data from 
a wide variety of existing applications, 
such as spreadsheets, other relational 
database packages, and even word pro- 
cessors. 


Using TerraView with Commercial 
Anphestions 

Developing a mapping application us- 
ing TerraView isn’t for the weak of heart. 
It’s a full-fledged Windows application, 
with the addition of numerous library 
calls to open and display data on a map. 
It requires programming talent, along 
with a normal application development 
effort, to bring this type of mapping to 
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(continued from page &8) 
the desktop. 

The positive side of this cautionary 
statement is that TerraView is extreme- 
ly flexible. I can envision the libraries 
being used in three different ways. First, 
users can construct a TerraView appli- 
cation, in much the same way I did, and 
communicate with other applications 
via a DDE interface. The TerraView ap- 
plication will probably be written to 
work with a specific application or even 
single data set, although it is also pos- 
sible to imagine a generic mapping ca- 
pability that can work with any data- 
driven application. 

Second, TerraView calls may be com- 
piled into a DLL and called by one or 
more applications specifically for map- 
ping functions. This approach may be 
provided by the commercial application 
vendor, or it may be added on by a third 
party or even the end user through DLL 
interfaces increasingly being included 
in commercial products. 

Third, and perhaps most interesting, 
the TerraView functions may be incor- 
porated seamlessly into a commercial 
application to include integrated map- 
ping. TerraLogics has a demo that in- 
cludes a TerraView application inte- 
grated as a user-defined SmartButton in 
Lotus 1-2-3 for Windows. While this 
demo SmartButton macro simply calls 
an external TerraView application, fu- 
ture versions of Lotus may be compiled 
with this feature built in. 

The combination of the TerraView 
mapping engine and libraries, along 
with inexpensive and widely available 
electronic maps provided by the Fed- 
eral government and by commercial 
vendors, may herald a new type of ap- 
plication for handling geographic data. 
Not everyone has the need for geo- 
graphic data but of those who do, many 
lack the technical ability to work with 
TerraView today. However, commercial 
developers may, in time, make these ca- 
pabilities available to every user of or- 
dinary commercial software. 
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“Raima Database Server's performance 





is roughly equi 
afterburner. 


John Michelsen knew what he wanted in a database. 
After doing his homework, John chose Raima Database 
Server as the client-server DBMS for his exciting new 
Dominion” Accounting Series. : 





Raima Database Server is the client-server database of 
choice for applications with demanding performance 
requirements. It has everything you look for in a client- 
server DBMS: ANSI-standard SOL, support for Microsoft 
ODBC and SAG client APIs, declarative referential 
integrity, and extension modules that allow you to execute 
user functions on the server via Raima’s embedded remote 
procedure call mechanism. 


And ultimately, performance. Raima Database Server 
delivers consistently high throughput and fast response 
times. We support all the major server platforms, including 


lent to hitting the 


’ _ John Michelsen, Millennium Software 


NetWare 386, OS/2, UNIX, and Windows NT. And Raima 


Database Server gives you all this with prices that blast the 
competition—for example, our unlimited user NLM is $8995. 


Hit the afterburner with your client-server application. 
See what our customers in design automation, workflow 


computing, document and image management, geographic 


information systems, process control, and vertical-market 
solutions already know. For a commercial product or an in- 
house project, Raima Database Server is the answer. 






In the US. or Canada, call: 


1-800-DB-RAIMA 


In Washington state or international, 
call 206-557-0200 Fax: 206-357-5200 


AIMIA 







Call today for a free 
white paper on Raima 
Database Server 








Seattle « Los Angeles * Chicago * New York « Australia « Belgium * Brazil « Costa Rica + Estonia * Finland + France * Germany » Italy 
Japan * Mexico * The Netherlands + Norway » Russia * Sweden + Switzerland « Taiwan * Turkey « United Kingdom 


© 1993 Raima Corporation. Raima Database Server is a trademark and Raima is a registered trademark of Raima Corporation. Other computer and software names are trademarks or registered 
trademarks of their respective holders. Raima Corporation, 1605 NW Sammamish Rd. Suite 200, Issaquah, WA 98027 USA. Millennium Software, Inc., 4223 Centergate, San Antonio, TX 78217 





eVvesaqd 





PROGRAMMER'S WORKBENCH 





f you have a DOS program, chances 

are you've thought of porting it to 

Windows. However, rewriting your 

entire application to work with 

Windows can be difficult and ex- 
pensive. To ease that burden, Microsoft's 
Visual C++ provides QuickWin, a library 
that allows you to port many text- and 
graphics-based DOS programs to Win- 
dows. But, it’s not a panacea—some 
programs require major changes to work 
with QuickWin. To examine the Quick- 
Win library, I decided to dust off Tur- 
tle, a Turtle-graphics program I devel- 
oped in a previous DD/ article; see 
“Programming with Phar Lap’s 286 | DOS- 
Extender,” (DDJ February, 1992). Turtle 
uses Microsoft C with Phar Lap’s 
286! DOS Extender. Since QuickWin al- 
lows programs to access more than one 
Mbyte (thanks to Windows), it shouldn't 
make much difference that the program 
originally used a DOS extender. How- 
ever, Turtle uses some techniques that 
won't work with QuickWin. In this ar- 
ticle, I'll discuss what it took to port Tur- 
tle (a moderately complicated Microsoft 
C program) to QuickWin. 


About QuickWin 

In its simplest form, QuickWin creates 
a single text window inside a multiple- 
document interface (MDD frame win- 
dow. This window is a surrogate for the 


Al is the author of several books, in- 
cluding DOS 6: A Developer’s Guide 
(M&T Books, 1993) and Commando 
Windows Programming (forthcoming 
from Addison-Wesley). He can be 
reached at 310 Ivy Glen Court, League 
City, TX 77573 or on CompuServe at 
72010, 3574. 
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A Quick Port 


with QuickWin 


Moving your graphics app from DOS to 
Windows has its payoffs—and pitfalls 


A\ Williams 


DOS console device. All output to std- 
out and stderr appears in the window. 
Keyboard input appears as data in the 
stdin stream. When your program ex- 
its, QuickWin leaves the window on the 
screen until the user closes it. 

Simple programs that use stdin and 
stdout for I/O work well with QuickWin. 
However, there are some restrictions: 


e You can’t spawn other programs. 

e QuickWin doesn’t allow you to call 
the Windows API. 

e Your program can’t use console I/O 
functions such as getchO. 

e You can't control the buffering of 
stdin—you can’t read a single char- 
acter of input. 

e You can’t directly access the screen. 

e The QuickWin menu can’t be changed. 


_wopen() 
_fwopen() 
_wgopen()* 
_wcelose() 
_wgclose()* 
_wsetexit() 
_wgetexit() 
_wsetsize() 
_wgetsize() 
_wsetscreenbuf() 
_wgetscreenbuf() 
_wsetfocus() 
_wgetfocus() 
_wgsetactive()* 
_wggetactive()* 
_wmenuclick() 
_wyield() 
_wabout() 
_inchar()* 


*Graphics-only functions 
Table 1: QuickWin Calls. 


e QuickWin’s help can’t be changed. 


If you have source code that you can 
compile and run with basic QuickWin, 
it should also compile for DOS or UNIX. 
If your program uses the Microsoft 
graphics library, QuickWin will create 
a graphics-output window to contain 
your program’s graphics. Once your 
program works with these default win- 
dows, the next step is to use QuickWin- 
specific features to make improvements 
to your program. 

Table 1 shows QuickWin’s enhanced 
calls (all are defined in STDIO.H). Some 
calls pertain to the QuickWin environ- 
ment. The _wabout() function, for ex- 
ample, sets the text that appears in the 
about box. The _wsetexitC function con- 
trols how QuickWin responds when the 





Opens text window; returns file handle. 
Opens text window; returns file pointer. 
Opens graphics window. 

Closes text window. 

Close graphics window. 

Sets exit behavior. 

Gets exit behavior. 

Sets text window’s position and size. 
Gets window’s position and size. 

Sets text window’s screen-buffer size. 
Gets text window’s screen-buffer size. 
Makes window active. 

Gets current active window. 

Sets active graphics window. 

Gets active graphics window. 

Simulates menu action. 

Yields processing time to other applications. 
Sets custom message for About box. 
Reads a character in a graphics window. 
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Personal Software Products 
Technical Interchange 










You don’t need a map to find your way to the 
most innovative software products 
around. Head for the IBM Personal 
Software Products (PS) Technical 
Interchange, where you'll catch the 
exciting breakthroughs coming 
down the road from PSP. 

Our last conference in Phoenix played to a sell-out crowd 
of software designers, independent and corporate developers, 
technical coordinators, LAN experts, MIS managers, consultants 
and training executives. This time, we'll have a keynote speech 
Walt Disney World’ Dolphin Hotel 
Lake Buena Vista, Florida 
August 29-September 2 





by Jim Cannavino, IBM Sr. VP and General Manager of Per- 
sonal Systems; interactive elective sessions on the latest in OS/2? 
LAN Systems, 32-bit graphics, object-oriented programming, 
multimedia, pen, database and communications; OS/2 and LAN 
labs; and an exhibit area with demos of vendor software that 


exploits PSP products. ‘There 
will be special bonuses, 
product raffles and an active 
schedule that even includes 
a “special event.” 
Registration fee is $895. 
For general and exhibit information or to register, call 
1 800 872-7109 in the USA and Canada? What you find out 
will keep your company heading in the right direction. 


This conference is co-sponsored by Computer Associates 


technology 


Technical Interchange 
featuring 


OS/2 and LAN Systems 






of 








International, Inc., Lotus Development Corporation and 
WordPerfect Corporation. 


Operate at a higher level: 
& 





1) DOW. 


*Outside the USA and Canada, call 1 508 443-4990. IBM and OS/2 are registered trademarks and “Operate at a higher level” is a we —v ee 
trademark of International Business Machines Corporation. Walt Disney World is a registered trademark of the Walt Disney wee 
Company. ©1993 IBM Corp. — 
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(continued from page 92) 

program exits. By default, QuickWin re- 
tains the program’s windows until the 
user closes them explicitly. With _wset- 
exit() you can override this behavior so 
that your windows close upon exit. 

Other QuickWin calls allow you to 
create new text and graphic windows. 
You can also change the size, position, 
and text capacity of any text window. 
If you use _wopen(), QuickWin returns 
a file handle that corresponds to a new 
text window. You pass this handle to 
other calls (like _ wsetsizeQ() to refer to 
the window. You use file handles with 
calls like readQO and writeQ(, not calls 
like fprintfO, which take a stream 
pointer. To get a stream pointer for a 
window, use _ fwopen() instead of 
_wopen(). You can get a file handle 
from a stream pointer using _ filenoQ. 

Both _wopenQ and _wfopen( take 
three arguments. The first two are struc- 
tures that determine the window’s title, 
text capacity, size, and position. The 
third argument determines the access 
mode to the pseudofile. 

By default, a QuickWin window can 
hold 2048 characters (a little more than 
a 25x80 display). However, you can 
change this limit when you create a win- 
dow or by using _wsetscreenbufO. You 
can set the text capacity by using a spe- 
cific number, or you can use one of two 
special constants: _WINBUFDEF or 
_WINBUFINF. The _WINBUFDEF con- 
stant sets the default buffer size (2048); 
_WINBUFINF sets no limit on the win- 
dow’s text capacity. If the window con- 
tains more text than it can display, 
QuickWin automatically provides and 
manages scroll bars. 

You can close a window using 
_wecloseQ). If you pass _WINNOPERSIST 
as an argument, QuickWin removes the 
window from view when you close it. 
If you want the window to remain, you 
can pass _WINPERSIST, instead. If you 
want your program to have a custom 
look, you might want to close the std- 
out window by specifying _welose 
(_ fileno(stdout),_ WINNOPERSIST). 

Graphics windows are not quite as 
sophisticated as text windows. You can 
open a new graphics window by call- 
ing _wgopenQ. This call returns a file 
handle. You then have to activate the 
new window with _wesetactiveV. You 
can close a graphics window with _we- 
closeQ.. Closing a graphics window al- 
ways causes it to disappear. Like text 
windows, you can close the default 
graphics window so that you can open 
a new one with your own title by spec- 
ifying _weclose(_wegetactiveD). You can’t 
control the size or position of graphics 
windows. You can set any legal video 
mode using the standard _setvideo- 
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mode() call. However, the window may 
be larger than the virtual graphics screen, 
and this can be disconcerting. For ex- 
ample, if you fill a 640x480 graphics 
mode with a color, it will look odd if 
the window is 700x500 pixels. The ex- 
tra pixels form a border that doesn’t fill. 


The Microsoft calls 
require more than 
64K to store a 
320X 200X256 
screen 





About Turtle 

Turtle is a graphics language similar in 
spirit to Logo. The original Turtle program 
only supports the VGA’s 320x200 x256 
mode. Since it uses Phar Lap’s 2861 DOS 
Extender, Turtle takes advantage of DLLs 
to provide an extensible command set. 
Although most Turtle commands are 
built in, you can add additional com- 
mands with a DLL. The default Save and 
Load commands are in a DLL. 

Turtle’s commands are straightfor- 
ward. You should be able to figure out 
its operation by referring to the online 
help. If you want more details about the 
original Turtle program, see the article 
in the February 1992 issue. To avoid 
confusion, I'll refer to the original ver- 
sion as Turtle 1.0 and the new Windows 
version as Turtle 2.0. The source code 
for the QuickWin version of Turtle is 
available electronically; see “Availabili- 
ty,” on page 5. The source files are the 
same as those for Turtle 1.0 (also avail- 
able electronically), although there are 
many significant changes. 


Problem Areas 

Porting Turtle to QuickWin presents sev- 
eral immediate challenges. The original 
program switches between a text and 
graphics screen. To do this, Turtle 1.0 
directly accesses video memory. It also 
reads and sets the text screen’s cursor 
position. None of these are possible un- 
der QuickWin. But thanks to Windows, 
sometimes less is more. Since Quick- 
Win uses different windows for graph- 
ics and text, the new Turtle adopts this 
model for output. All the cursor-posi- 
tioning code and most of the direct 
screen accesses vanish with separate 
windows. The gotextO function, which 
switches to text mode, becomes an 
empty stub; gograph( initializes the 
graphics window the first time you call 
it. Subsequent calls to it do nothing. The 


Show command becomes unnecessary 
with this scheme, so Turtle no longer 
supports it. The only other direct screen 
accesses occur when you save or load 
the screen to a file or buffer. Since these 
operate on the graphics window, we 
can use Microsoft’s standard _ putimageQ) 
and _ getimage() calls to effectively read 
and write the graphics window. 


Huge pointers. While _ putimage( and 
_ getimage( will work to read and write 
the graphics screen, it presents a prob- 
lem for the new version of Turtle. Tur- 
tle 1.0 operates on a 320200256 
screen. Therefore, it always deals with 
blocks of memory exactly 64,000 bytes 
long. The Microsoft calls require more 
than 64K to store an entire 320200256 
screen, due to some overhead in the 
image (more about that later). Although 
QuickWin programs can malloc( large 
amounts of memory, they still suffer 
from the 64K-per-object limit. Therefore, 
the new Turtle has to resort to huge 
pointers to deal with screen buffers. You 
can learn the exact size of a screen 
buffer from the _imagesizeQO function. 

Help windows. Turtle 1.0’s help sys- 
tem uses getch( to pause between help 
screens. QuickWin, of course, doesn’t 
support any console I/O calls. Again, 
less is more—the new Turtle opens a 
separate window to contain the help in- 
formation. Turtle sets the help window’s 
buffer size to _WINBUFINEF, so the win- 
dow will retain all text sent to it. You 
can use the window’s scroll bars to 
browse the help information. Subse- 
quent help commands simply bring the 
existing help window to the foreground. 
Turtle 2.0 doesn’t need getchQ. That’s 
good, because I couldn’t find a direct 
way to replace getchO or kbhitO. 

The help system causes each com- 
mand to print its own help to the std- 
out stream. Therefore Turtle needs a 
way to redirect stdout to the help win- 
dow. Ordinarily, you would use the 
dupO and dup20 calls to redirect a 
stream. However, you can only pass 
QuickWin’s special file pointers to a few 
functions. Unfortunately, dupQO and 
dup20 are not among them. Turtle re- 
sorts to the method shown in Figure 1 
to change the stdout stream. 

DOS shell. Another problem is that 
the original Turtle could run a DOS shell 
and a text editor, and display a DOS di- 
rectory. QuickWin doesn’t allow any of 
these operations. However, under Win- 
dows, these are not very important. You 
can always switch to a DOS window or 
an editor by using Windows. Turtle 2.0 
simply deletes these commands. 

Interrupting execution. Turtle can 
execute script files. While a script file is 
running under Turtle 1.0, you can press 
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Control-Break to interrupt execution. Un- 
der QuickWin, you can’t catch Control- 
Break. If Turtle gets stuck in an endless 
loop, you’re simply out of luck. How- 
ever, the new Turtle will break out of 
all running scripts if you enter a Q (up- 
per or lower case) while Turtle is wait- 
ing for input (the %%7 special variable). 

DLLs. Even though Windows sup- 
ports DLLs, QuickWin doesn’t allow you 
to call the Windows API. Therefore, I 
didn’t even attempt to port Turtle’s DLL 
system to QuickWin. Since the system 
depends on some Phar Lap-specific 
functions, it probably would have been 
difficult to port anyway. The new Save 
and Load commands, of course, have 
to move to TCMDS.C. 


Other Changes 

The new Turtle program sports several 
minor changes. The Delay command, 
for example, couldn’t use the special 
Phar Lap interrupt calls. Some variables 
and functions that Turtle no longer 
needs were deleted. However, some 
things from the old program still remain, 
but are unused. For example, Turtle 1.0 
uses large model, but Windows can’t 
load multiple copies of programs that 
use large model. In an ordinary Windows 
application, you could prevent multiple 
copies from running, but not in Quick- 
Win. It was a simple matter to change 
Turtle to use small model. Only the 
screen buffers need huge pointers, any- 
way. This prevents the new Turtle from 
using freadQO and fwriteO inside the 
Save and Load commands, however. 

Some changes were not strictly nec- 
essary, but were worth the small effort 
required. By default, when your pro- 
gram exits, QuickWin retains your win- 
dows until the user closes them. By call- 
ing _wsetexit(_WINEXITNOPERSIST), 
QuickWin will close your windows 
when you exit, which is a more natu- 
ral method for Turtle. 

By default, while Turtle is running, 
other Windows programs can’t execute. 
(Remember, Windows multitasking is 
cooperative.) To make Turtle more po- 
lite, the XCI module calls _wyieldO pe- 
riodically while processing scripts. This 
allows other programs to run while Tur- 
tle is performing lengthy operations. 

Since Turtle can no longer directly ac- 
cess graphics memory, it doesn’t de- 
pend on the 320x200 256 mode any- 
more. As an experiment, I added a 
mode command that allows you to try 
different graphics modes. However, Tur- 
tle always assumes 256-color mode, re- 
gardless of the mode you are using. 


Turtle in Action 


Turtle certainly looks good as a Win- 
dows application; see Figure 2. By us- 
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ing the standard QuickWin menus, you 
can copy text or graphics to the clip- 
board, and manage the child windows 
as you would expect in a MDI applica- 
tion. Of course, the help menu only ex- 
plains QuickWin’s operation—you can’t 
customize it. Also, Microsoft doesn’t doc- 
ument this, but under QuickWin, _ put- 
image) and _ getimage(V) operate on 


FILE old_stdout; 
FILE *helpwin; 


standard Windows bitmaps. That means 
that Turtle can now read and write BMP 
files! This was certainly an unexpected 
bonus; however, QuickWin may not set 
the color palette correctly for some files. 
Prior to Visual C++, QuickWin did not 
support graphics. While the graphics sup- 
port is welcome, it is also a major weak 
(continued on page 98) 


/* Not a pointer */ 
/* set by fwopen() somewhere else */ 


old_stdout=*stdout; /* save stdout */ 


*stdout=*helpwin; 


printf("This goes to help window") ; 


/* go back to old stdout */ 
*stdout=old_stdout; 





Figure 1: Redirecting stdout to the help window. 
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Autodesk University Presents Higher 


Introducing Autodesk University, the premier event 
for users of Autodesk software including AutoCAD, 
3D Studio and Generic CADD. Produced by 
Autodesk and Miller Freeman (the publishers of 
CADENCE magazine), Autodesk University will 
feature hundreds of hours of hardcore technical 
instruction from the best independent instructors as 
well as Autodesk’s own technical gurus. This first 
annual event is happening October 11-15, 1993 at 
the Bill Graham Civic Auditorium in San Francisco. 
Autodesk University will feature lectures, tutorials, 
product demonstrations and a host of other unique 
learning opportunities. You'll get the application- 
specific information and training you need — and 


you'll get it all in 5 days. 
{ A Conference Within a Conference } 


Autodesk University will be held in conjunction with 
the North American AutoCAD Users Group 
’ (NAAUG) Annual Conference. NAAUG 

) : was started in 1990 and has grown to over 
3,000 members in just 3 years. This means 


you ll be able to network and brainstorm with 





thousands of the best and brightest AutoCAD 


professionals in one place at one time. 


{ What’s Your Major? } 


No matter what application you’re currently using, 
Autodesk University has something for everyone. 
The technical program will feature 10 concurrent 
tracks: A/E/C, Mechanical, Multimedia, Generic 
CADD, AutoCAD, Scientific Modeling, Continuing 
Education, Developers, CAD System Management 
and GIS — over 150 classes so you can customize a 


program that’s right for you. 


{ Are Your Tools Making the Grade? } 


As an Autodesk user, one of the toughest challenges 
you face is keeping up with new technologies. Every 
day new products are emerging that help you do 
your job better, faster and more efficiently. Whether 
it’s system management, 3D design, plotting or 
drawing management, there are hundreds of 
customized solutions that can have an immediate 
impact on your bottom line. The trick is knowing 


where to find them. 
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Education for Serious Autodesk Users. 
{ Put Your Skills to the Test } { Extracurricular Activities \ 
The comprehensive products exhibition will feature You'll have some major fun outside of class too. 
more than 125 exhibits allowing you to test your new- There will be a keynote address by Autodesk’s 
found knowledge on the exhibit floor and get dynamic new CEO, Carol Bartz, the 1993 Autodesk 
immediate answers to your toughest International Image and Animation Contest, 
~— questions. Virtually every Autodesk’s traditional Friday beer blast and more. It 
H = =major AutoCAD software all adds up to an experience you won't want to miss. 
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will be showcasing graphic for more information! 





cards, systems, monitors, printers, plotters, CAD 





systems, optical storage devices and a variety of other 
leading edge products and services. Don’t miss out 


on this unique interactive learning experience. 


D YES! Send me a FREE Course Catalog. I’m interested in LJ Attending (_J Exhibiting 
pTODEs 
b & 
\ G NAME ADDRESS 
TITLE CITY STATE/PROV. ZIP/POSTAL CODE COUNTRY 
U N I V E R S I ‘a Y COMPANY PHONE FAX 
Sonterencs SEs ation AUTODESK UNIVERSITY puone (415) 905-2354 ¢ rax (415) 905-2220 ¢ P.O. Box 7843, San Francisco, CA 94120-7843 
DDAA-2 





IN - GIS MECHANICAL - AEC > MULTIMEDIA - GENERIC CADD - AUTOCAD - SCIENTIFIC MODELING » CONTINUOGSUVUS EDUCATION « 





ne a ey ee ae ee ae eee 


°° G@QGWS9 FJI¥USZNAS - 








* DEVELOPERS - 


’ TWDOINWHSAWw 


ee Bi 


Widsawistimw °- 





* @wooind 


°° SNIDTSBGOW SIidaiLNIiss 


°° NOMVINGA SHNONMNILNGS 


© SHIM OwWIAIG 


NOMVeLsiniwayv aqvs 


Sis -« 


IWSOINWHOIW °« 





oe Bae 


DEVELOPERS - 












kin to the , 
Ac 
Rubik's Cube, 
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must restore g@™ 
order from 
chaos in this 
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strategy game. 
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Computer System 





30 Runner-up Prizes 
Hot Software 


1,000’s of Honorable Mentions 
COGITO T-Shirts 








See your local 
retailer, or call 


{ coGiTO 1-800-453-7671 
; Ext. 120 


Play COGITO and Win Prizes! 
It's simple. Fill out an entry form, included in all COGITO pack- 
ages, return it with your dated sales receipt (price circled) and a 
25-word essay on why you enjoy playing COGITO. As a special 
bonus, if you reach level 120, write the password code on your 
entry form, and we'll send you an “I Beat COGITO” T-Shirt, 
absolutely free (a $15.95 value). But hurry, the contest runs 
from June 1 to December 31, 1993. Void where prohibited. 


INLINE SOFTWARE 


308 Main Street, Lakeville, CT 06039 
203-435-4995, Fax: 203-435-1091 





COGITO is a registered trademark of 
Atreid Concepts, S.A. 
Available for Macintosh and Windows. 
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Figure 2: QuickWin version of Turtle. 


(continued from page 95) 
point in the package. When a window 
is larger than the virtual graphics screen 
it represents, the effect is disconcerting. 
The user (but not the program) can tell 
QuickWin to scale the graphic to fill the 
window, but this slows processing and 
can distort the image. You can’t control 
the placement or size of graphics win- 
dows from within your program. 
Considering its complexity, Turtle was 
surprisingly easy to port to QuickWin. 
Of course, tweaking the design— creat- 
ing separate text and graphics windows, 
for example—helped ease the transition. 
These changes improved Turtle’s look 
and feel, too. If Turtle had originally been 
a true DOS program instead of a DOS- 
extended program, the DLL use would 
not have been a problem. Also, the break 
handling was a disappointment. The 
workaround— detecting the Q key on 
input— isn’t a very good solution. If your 
program sticks in a loop that doesn’t do 
input, you won't have any recourse but 
to close the application. 


Is QuickWin for You? 

Turtle is probably about as complex a 
program as you would want to port to 
QuickWin. Even though the port was 
successful, there were a few quirks. If 
you just want to get your DOS program 
over to Windows as soon as possible, 
QuickWin works well. However, if you 
plan on continuing development of your 
program under Windows, QuickWin is 
essentially a dead end. Although you 
can make certain improvements (sepa- 
rate output windows, for example) to a 
QuickWin program, you can’t call the 
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Windows API. Once you move your 
program to QuickWin, you can’t make 
many Windows-oriented improvements. 
By using a custom DEF file, you can 
bind a DOS version of your program 
with the QuickWin version. Then you 
will have a single executable (made 
from the same source code) that runs 
under DOS or Windows. Consult the 
Microsoft Visual C++ documentation for 
more details about binding DOS pro- 
grams to Windows applications. 
Certainly QuickWin is not a long-term 
answer to developing Windows appli- 
cations. Still, it will make your DOS pro- 
gram behave better under Windows (es- 
pecially in standard mode) and give it 
a better look and feel. Your QuickWin 
program will have access to more mem- 
ory than a DOS program. Nevertheless, 
QuickWin is no DOS extender (although 
Windows actually is). QuickWin is prob- 
ably too limited to port most real DOS 
applications to Windows, but it’s useful 
for writing quick programs that you 
would ordinarily write for DOS. 
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What a grind. 

Who would have guessed 
that cranking out a GUI on 
your own would take so much 
time and tinkering? Face it: 
GUI code requires a lot of 
grind, and too much of your 
time. 

So instead of spending 
months developing a GUI from 
scratch, let ICS help you build 
one in a fraction of the time— 
with Builder Xcessory™ (BX™) 
2.5. It’s the best-selling palette- 
based development tool that lets 
you “paint” a great looking, 
great performing GUI in no 
time. BX writes the code for 
you! | 

All ICS graphic tools and services save 
you time, money and effort developing for the 
OSF/Motif™ environment. We’re the Motif™ experts: 
everything we offer helps you create 
great GUIs quickly and inexpensively. 

Still #1 in the world. 

BX is and always will be the 
most popular interface development 
tool in the world. Why? Because it’s the 
easiest-to-use, easiest-to-learn Motif tool, 
and it dramatically cuts your GUI develop- 


ment time and cost without sacrificing qual- 





ity. Here’s how: 3.0! Call today. 





Integrated Computer 
Solutions Incorporated 


Graphic Improvements In Productivity 













nd other 
ICS tools. And if you purchase BX 
2.5 between 6/1/93 and 8/1/93, 
you'll also get a FREE upgrade to BX 





e Standard—BX delivers clean, 
standard C, UIL or Ada code 

© Advanced Functionality—BX 
3.0, a forthcoming upgrade, 
supports C++ code generation, 
Motif 1.2, internationalization 
and more 

¢ No Royalty—BX-generated 
code does not require ANY 
run-time fees; what you build 
is yours 

© Custom Widgets—Simply take 
your own widgets or any from 
the ICS Widget Databook"’— 
our catalog of pre-built, inten- 
sively-tested widgets—and plug 
them into BX to create a cus- 


tom interface 


¢ A Tool Family—ICS integrated tools and 
ervices make GUI development a breeze 
FREE CD, Widget Databook 
and Upgrade! 

To introduce you to BX, and the entire 
e of ICS tools and services, we’ll send you our 
CD, “Tools for Motif Developers,” and Widget 
Databook FREE! The CD% lets you 
demo BX 7 ‘fe: 
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d Upgrade. 


Databook an 


Integrated Computer Solutions, Inc., 201 Broadway, Cambridge, MA 02139; Telephone: (617) 621-0060; Fax: (617) 621-9555; E-Mail: info@ics.com 


All trademarks and registered trademarks are the property of their respective owners. 
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LINKED LISTS 


Listing One (Text begins on page 32.) 


/* LINKED LIST TOOLKIT -- Copyright (C) 1998 by Garyl Lee Hester 
* 11.h -- Global header file */ 
#ifndef TRUE 


#define TRUE 1 
#define FALSE i) 
#tendif 


#define _LL_NEXT 1 
#define _LL_PREV 2 
#define _LL_BEFORE 3 
#define _LL_AFTER 4 
typedef void * PATOM; /* pointer to atom */ 
typedef void * PGEN; /* generic pointer */ 


/* Link List Bind Structure (LLBIND) */ 
typedef struct LL_BIND 
{ 


/* reference to next link */ 
/* reference to prev link */ 


struct LL_BIND *pPrev; 
struct LL_BIND *pNext; 
} LLBIND, *PLLBIND; 
/* Link List Head & Tail Structure (LLENDS) */ 
typedef struct LL_ENDS 
{ 


PGEN pHead; 

PGEN pTail; 
} LLENDS, *PLLENDS; 
/* Link List Block Control Strucure (LLBC) */ 
typedef struct LL_BLOKCNTL 
{ 


/* generic head pointer */ 
/* generic tail pointer */ 


struct LL_BLOKCNTL *pPrev; 
struct LL_BLOKCNTL ¥*pNext; 
unsigned usUsageCnt ; 
} LLBC, *PLLBC; 
/* Link List Control Structure (LL) */ 
typedef struct LL_CNTL 
{ 


/* ref to prev block */ 
/* ref to next block */ 
/* usage count */ 


LLENDS Block; /* ends of block list */ 
LLENDS ‘Free; /* ends of "free" atom list */ 
unsigned usAtomSize; /* size of link Atom */ 
unsigned usAtomCnt; /* number of Atoms per block */ 


} LLCB, *PLLCB; 
typedef struct LL_LIST 
{ 


PLLCB pLL; /* reference to master list */ 
LLENDS Ends; /* ends of the current sub-list */ 
} LLST, *PLLST; 
typedef int (*COMPFUNC)( void *, void * ); 
/* Macros used by 11 package only: MAKEPBIND(p), converts an atom ptr to a 
* bindary ptr; MAKEPATOM(p), converts a bindary ptr to an atom ptr */ 
#define MAKEPBIND(p) ((PLLBIND) ((char *)(p) - sizeof (LLBIND)) ) 
#define MAKEPATOM(p) ( (PATOM) ((char *)(p) + sizeof(LLBIND) ) ) 
/* User Functions supplied by Macros */ 





HALO IMAGING TOOLS 
GIVE PROGRAMMERS THE 


POVVER TO VVRITE 
IMAGING MAGIC. 


Sophisticated tools for today’s programmers 

who need state-oHhe-art imaging in their 

C and C++ applications. Create powerful image- 
enabled programs with the first multi-platform 
imaging API from Media Cybernetics. 

Slash months from your development effort 


with our award winning, market-proven 





technology. 


HALO Imaging Library 


Manage multiple images in memory ® Convert between bilevel, grayscale, 
palette and true color @ Perform halftoning and other types of color reduction ¢ 
Sharpen, blur and remove image noise ® Adjust image brightness, contrast and 


gamma ® Read and write TIFF, JPG, PCX, GIF, BMP, PICT, and TGA files 


Perform smooth scaling, affine, rotation (any angle). 


HALO Advanced Imaging Library 


Define complex {even disjoint) areas of interest © Count objects and perform 





#define 11_next(p) 11_getbind (_LL_NEXT, (PATOM) (p) ) 

#define 11l_prev(p) 11_getbind(_LL_PREV, (PATOM) (p) ) 

#define 11l_mvbefore(l,s,t) 11_mvatom((s) ,_LL_BEFORE, (t) ,&(1)->Ends) 
#define ll_mvafter(1,s,t) 11_mvatom((s),_LL_AFTER, (t) ,&(1)->Ends) 
#define ll_insbefore(1l,s,t) 1l_insatom((s) ,_LL_BEFORE, (t) ,&(1)->Ends) 
#define 1l_insafter(1,s,t) 11l_insatom((s),_LL_AFTER, (t),&(1)->Ends) 
#define 11_first(p) 11_frstatom((p), (p)->Ends.pHead) 

#define 11l_last(p) 11_lastatom((p), (p)->Ends. pTail) 

#define 11_swap(l,s,t) 1l_swapatom((s), (t),&(1)->Ends) 

#define 1l_append(1,s) 11_appatom((s) ,&(1)->Ends) 

#define 11l_unbind(l,s) 11_unbatom((s) ,&(1)->Ends) 

#define 11_memoff(p,m) (unsigned) ((char *) (&(p)->m)-(char *) (p)) 
/* Similar Functions for Handling the Free List */ 

#define 11_fmvbefore(1,s,t) 11_mvatom((s) ,_LL_BEFORE, (t) ,&(1)->Free) 
#define 11l_fmvafter(1,s,t) 11_mvatom((s),_LL_AFTER, (t),&(1)->Free) 
#define 11_finsbefore(1,s,t) 1l_insatom((s) ,_LL_BEFORE, (t) ,&(1)->Free) 
#define 11l_finsafter(1,s,t) 1ll_insatom((s),_LL_AFTER, (t) ,&(1)->Free) 
#define 11_ffirst(p) 11_frstatom((p), (p)->Free. pHead) 

#define 11_flast(p) 11_lastatom((p), (p)->Free.pTail) 

#define 11_fappend(1,s) 1l_appatom((s) ,&(1)->Free) 

#define 11_funbind(l,s) 11_unbatom((s) ,&(1)->Free) 

/* Function prototypes: llprim.c - linked list primitives */ 

PLLCB 11_open( PLLCB, unsigned, unsigned ); 

void 11_close( PLLCB ); 

PLLST 11_mklist(°PLLCB, PLLST ); 

void 11l_rmlist( PLLST ); 

PATOM 1l_alloc( PLLST ); 

void 11_free( PLLST, PATOM ); 

/* 1llbase.c - linked list management */ 

void 11l_appatom( PATOM, PLLENDS ); 

void 11_mkblock( PLLCB ); 

void 1l_rmblock( PLLCB, PLLBC ); 

PLLBC 11_inblock( PLLCB, PATOM ); 

void 11l_unbatom( PATOM, PLLENDS ); 

PATOM 11_frstatom( PLLST, PLLBIND ); 

PATOM 11_lastatom( PLLST, PLLBIND ); 

PATOM 1l_getbind( unsigned, PATOM ); 

/* llins.c - insert and move atom routines */ 

void 11_mvatom( PATOM, unsigned, PATOM, PLLENDS ); 

void 1l_insatom( PATOM, unsigned, PATOM, PLLENDS ); 

/* llswap.c - atom swap routine */ 

void 11_swapatom( PATOM, PATOM, PLLENDS ); 

/* llsort.c - shell sort routine */ 

void 11l_sort( PLLST, short, unsigned, COMPFUNC ); 


Listing Two 


/* LINKED LIST TOOLKIT -- Copyright (C) 1990 by Garyl Lee Hester 
* llprim.c -- Routines for Linked List Primitives */ 

#include <stdio.h> 

#include <memory.h> 

#include <malloc.h> 


Available for— 
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IBM® OS/2® 
UNIX® Motif™ 
UNIX®OPEN LOOK™ 
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#include "ll1.h" 


/* 1l_open - initialize a new linked list control */ 
PLLCB 1l_open( PLLCB pLL, unsigned usAtomSize, unsigned usAtomCnt ) 
{ 


unsigned usRet = 0; 
if( pLL ) 
{ 

/* if the list is already active, destroy it */ 

if( pLL->Block. pHead ) 
1l_close( pLL ); 

memset( (PGEN)pLL, @x@@, sizeof( LLCB ) ); 

pLL->usAtomSize = usAtomSize; 

pLL->usAtomCnt = usAtomCnt; 


} 
return( pLL ); 
} 
/* ll_close - closes a linked list */ 
void 1l_close( PLLCB pLL ) 
{ 
if( pLL ) 
{ 


while( pLL->Block.pHead ) 
ll_rmblock( pLL, (PLLBC)( pLL->Block.pHead ) ); 
memset ( (PGEN)pLL, @x@@, sizeof( LLCB ) ); 
} 
} 
/* 11_mklist - make a new sub list */ 
PLLST 11_mklist( PLLCB pLL, PLLST pList ) 
{ 
if( pList && pLL ) 
{ 


pList->pLL = pLL; 
pList->Ends.pHead = NULL; 
pList->Ends.pTail = NULL; 


return( pList ); 


/* 1l_rmlist - destroys a sub list */ 
void 11_rmlist( PLLST pList ) 
{ 

if( pList ) 

{ 

while( pList->Ends.pHead ) 
1l_free( pList, MAKEPATOM( pList->Ends.pHead ) ); 

} 
} 
/* 1l_alloc - return ptr to new atom, else NULL */ 
PATOM 1l_alloc( PLLST pList ) 
{ 

PLLBIND pRet = NULL; 

PLLBC pBlock; 

PLLCB pL; 


if( pList ) 
{ 
pLL = pList->pLL; 
/* if pFreeHead is NULL, then a new block needs to be created. */ 
if( pLL->Free.pHead == NULL ) 
11_mkblock( pLL ); 
/* if pFreeHead is STILL NULL, then there is no more memory */ 
if( pLL->Free.pHead ) 
{ 


pRet = (PLLBIND)( pLL->Free.pHead ); 
if( ( pBlock = 1l_inblock( pLL, pRet ) ) ) 
pBlock->usUsageCnt+t+; 
11_unbatom( MAKEPATOM( pRet ), &pLL->Free ); 
1l_appatom( MAKEPATOM( pRet ), &pList->Ends ); 
pRet = MAKEPATOM( pRet ); 
} 
} 
return( (PATOM) pRet ); 
} 
/* 11_free - remove pAtom from pList and add to global free chain */ 
void 1l1_free( PLLST pList, PATOM pAtom ) 
{ 
PLLBIND pBind; 
PLLBC pBlock; 
PLLCB pLL; 
if( pList && pAtom ) 
{ 
pLL = pList->pLL; 
pBind = MAKEPBIND( pAtom ); 
1l_unbind( pList, pAtom ); 
ll_appatom( pAtom, &pLL->Free ); 
if( ( pBlock = 1l_inblock( pLL, pAtom ) ) ) 
if( !( --pBlock->usUsageCnt ) ) 
11_rmblock( pLL, pBlock ); 


End Listings 
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C++ TEMPLATES 


Listing One (Text begins on page 44.) 
#define EOS '\Q' 
template <class T,int cacheSize> 


#ifdef __cplusplus virtArray<T,cacheSize>: :virtArray(unsigned long tnumEls,T *defVal) 
#ifndef VIRTARRA_H { 
#define VIRTARRA_H if ( tnumEls ) 
{ 
template <class T,int cacheSize=100> unsigned long totsize; 
class virtArray char *tptr; 
{ initialized=1; 
private: tempFile=new tfile; 
int initialized; numEls=tnumE1s; 
unsigned long cacheStart; curE1=@L; 
unsigned long curE1; size=(sizeof(T)); 
unsigned long numE1s; totsize=numE1s* (long) size; 
size_t size; // no default value. Just set everything to NULLS 
tfile *tempFile; if ( defVal==@ ) 
T data[cacheSize] ; { 
void put(unsigned long i); memset (&data,EOS,size) ; 
void get(unsigned long i); totsize=numE1s* (long) size; 
public: int grain=20480; 
virtArray(unsigned long tnumEls,T *defVal=9) ; tptr=new char [grain] ; 
~virtArray(); if ( tptr==0 ) 
T& operator [] (unsigned long i); { 
T& current() { return operator [] (curEl); }; if ( tptr==0 ) 
T& next() { { 
if ( (curEl+1L<numEls) ) grain=10240; 
{ tptr=new char[grain]; 
curEl++; if ( tptr==@ ) 
} { 
return(current()); grain=2048; 
} tptr=new char[grain]; 
T& prev() { } 
if ( (curEl) ) if ( tptr==@ ) 
{ { 
eurEl<-~; initialized=0; 
delete tempFile; 
return(current()); return; 
} } 
void null0out(); } 
void grow(unsigned long numToAdd) ; } 
¥3 memset (tptr,EOS, grain) ; 
#endif while ( totsize>grain && !(tempFile->getErrno()) ) 
fendif { 
tempFile->write(tptr,grain) ; 
6 e of -= ne 
Listing Two totsize-=grain; 


if ( totsize && !(tempFile->getErrno()) ) 
#include "stdio.h" 


#include "stdlib.h" tempFile->write(tptr,totsize) ; 
#include "string.h" } 

#include "tfile.h" : delete tptr; 

#include "virtarra.h" if ( tempFile->getErrno() ) 


delete tempFile; 
initialized=0@; 


GRAF/DRIVE PLUS 3.0/3.5 i 


// Use the default value sent to constructor 
memcpy (&data,defVal,size) ; 


- Now available for ( unsigned long loop=OL a ss 
Turbo Graphics for for Turbo tga && tempFile->getErrno()==0 ; 
{ 


Printers and Plotters Pascal 7 , tempFile->write (data, size); 


if ( tempFile->getErrno() ) 


Publication-quality hard copy graphics for Turbo C & Pascal, with ” ales tempFile; 
minimal change to your screen graphics code. We write BGI drivers ¢ beeeceereeree 
that attach to the standard C/Pascal graphics library. You'll see our } 
drivers in commercial software for desktop publishing, business ae 
charts, investment analysis, maps, and science and engineering. 
LaserJet, Epson, DeskJet, DeskJet 500C, Canon Laser, PostScript, | ae cises Tine cuchest® 
ProPrinter X24, PaintJet, HPGL plotters, and more. Pe enone eee eae! 
PCX, TIFF, CGM, WPG, DXF, VideoShow, color dot matrix printers, if ( initialized ) 
and more (DTP Driver Disk). O gates aan abise 
GUI friendly—unlike our competitors, we don’t clear your screen. initialinadeds 
Portrait or landscape, any size from 1 inch to 5 feet. } 
Not a screen dump. You get the full printer resolution. template <elase-T.dnt cachesizes 
Not TSR. Loads on the heap at runtime. EMS optional. . virtArray<T,cacheSize>::operator [] (unsigned long i) 
Arc, bar3d, circle, fillpoly, line, ellipse, pieslice, line/fill patterns, if eeihe-eeade pest end Ve reovie in elenent-D 
etc—all 100% interchangeable with Turbo’s screen graphics. Also a ( i>numE1s ) 
putimage, with some limitations. Plot to LPT, COM, or disk. , aa 
Use PostScript fonts and LJ soft fonts on appropriate printer, plus tok gee ee ee ee ee ee ee 
Borland stroke fonts and default font on any device. ee eee PIS eee uate wore acres) 
e "Highly recommended - Jeff Dunteman, Dr. Dobbs. ee fiecocheee anti: 
Order v3.0 for Turbo C/C++and Pascal 5-7 real mode, or v3.5 for — 
Pascal 7 only, real/protected mode. Personal License $149, { 
Developers with royalty-free distribution $299. DTP Drivers $99. [ened ean 
30-day m/b guarantee. get (i): : 


cacheStart=curEl1; 
return(data[@]); 


FLEMING SOFTWARE BOX 569 OAKTON, VA 22124 = 
CANK) Se 


template <class T,int cacheSize> 
void virtArray<T,cacheSize>::put (unsigned long i) 
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{ 
if ( i<numEls ) 
{ 
int putSize=cacheSize; 
tempFile->seek(i* (long) size) ; 


if ( (itputSize)>numEls ) 
{ 
putSize=(numE1s-i) ; 


tempFile->write(&data[@] , putSize*size) ; 

} 
} 
template <class T,int cacheSize> 
void virtArray<T,cacheSize>::get (unsigned long i) 
{ 

if ( i<numEls ) 

{ 


int getSize=cacheSize; 
cacheStart=i; 
tempFile->seek (i* (long) size) ; 
if ( (itgetSize)>numEls ) 
{ 

getSize=(numE1s-i) ; 


tempFile->read (&data[@] , getSize*size) ; 
} 
} 


// Use this function to do the something like a memset().. 


template <class T,int cacheSize> 
void virtArray<T, cacheSize>: :null0ut () 
{ 
char *tptr; 
unsigned long totsize; 
memset (&data,EOS,size) ; 
totsize=numE1s* (long) size; 
int grain=20480; 
tptr=new char [grain] ; 
if ( tptr==0 ) 
{ 
if ( tptr==@ ) 
{ 
grain=10240; 
tptr=new char [grain] ; 
if ( tptr==@ ) 
{ 
grain=2048 ; 
tptr=new char [grain]; 
} 
if ( tptr==0 ) 
{ 


grain=512; 
tptr=new char [grain] ; 
} 
} 
} 
memset (tptr,EOS,grain) ; 
while ( totsize>grain && !(tempFile->getErrno()) ) 
{ 
tempFile->write(tptr, grain) ; 
totsize-=grain; 
} 
if ( totsize && !(tempFile->getErrno()) ) 
{ 
tempFile->write(tptr,totsize) ; 


delete tptr; 
get (curE1) ; 
return; 


// allow the array to grow 
template <class T,int cacheSize> 


void virtArray<T,cacheSize>::grow(unsigned long numToAdd) 


{ 
unsigned long bytesToAdd=@L; 
unsigned int grain=10240; 
char *tptr; 
bytesToAdd=numToAdd* (long) size; 
for ( tptr=@0,grain=10240 ; grain!=0 ; ) 
{ 
tptr=new char [grain] ; 
if ( tptr==@ ) 
{ 


grain-=2048; 
} 


if ( grain!=0 && tptr!=0 ) 


tempFile->seek(@L,SEEK_END) ; 


while ( bytesToAdd>grain && !(tempFile->getErrno()) ) 
{ 


tempFile->write(tptr, grain) ; 
bytesToAdd-=grain; 


if ( bytesToAdd && !(tempFile->getErrno()) ) 
{ 
tempFile->write(tptr,bytesToAdd) ; 


delete tptr; 
numElst+=numToAdd; 
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Listing One (Text begins on page 60.) 


// Mapper. hpp 

#define NOLOCK 1 

// these constants would be in a default file 

// or WIN.INI (for a Windows app): 

char cMap[] = "C:\\MAPTEST" ; // Mapper.Dat location 
char cLinkL[] = "C:\\MAPTEST" ; // Linkedl.Dat location 
#ifndef MAPPER 

#define MAPPER 

#include <stdio.h> 

#include <sys\locking.h> 

#include <share.h> 

#include <io.h> 

#include <fcntl.h> 

#include <string.h> 


class Mapper 
( 
private : 
int fp ; // file pointer 
long 1BytePosition ; 
char cBytePosition [9] ; // hex representation of long value 
char * cMapperFileSpec ; // Mapper.dat full file name 


struct MapperBuffer // layout of the Index entry 
{ 
char cDevice [1] ; // device where image is 
char cPath [2] ; // directory or Jukebox platter 
char cFileExtension [3] ; // type of image 
} Map ; 


void WipeMapper() {strnset((char *)&Map,'\®', sizeof (Map) );} 
char cMwholefilename [19]; 

public : 
Mapper() ; 


“Mapper() ; 

int Close() ; 

char * Hexbytes(){return cBytePosition ;} 
long 1MapSlot() { return 1BytePosition ; } 
char * LockSpot() ; 


int Open() ; 

char * Read(long 10ffset) ; 

int Write() ; // commit to disk 

int Write(char * Extension, // Image type 


char * Path, // subdirectory or jukebox platter 
char * Device) ; 


i 
#endif // MAPPER 


#ifndef LINKEDLIST 
#define LINKEDLIST 
class LinkedList 
{ 
private : 
int fp ; // file pointer 
long 1BytePosition ; 
char * cLinkedListFileSpec ; 
struct LinkedListBuffer 
{ 
long Previous ; 
long Next ; 
long MapperAddress ; // points at Mapper Index entry 
} ; 
Mapper * M; 
public : 
LinkedList() ; 
“~LinkedList() ; 
int Close() ; 
int Linkin(long OldEntry) ; 
long lLinkSlot() { return 1BytePosition ; } 
char * LastImage(long l0ffset) ; 
char * LockSpot() ; 
long MapAddress() {return 11.MapperAddress ;} 
long Next(){return 11.Next ;} 
int Open() ; 
char * Read (long) 
int Write (char 
char 
char 


Extension, // Image type 
Path, // subdir or jukebox platter 
Device) ; 


* % Hee 


ae 
#endif // LINKEDLIST 
Listing Two 


#include "Mapper.hpp" 
// MAPPER METHODS 


Mapper: : Mapper () 
{ 


fp = 1BytePosition = @ ; 
Open() ; 


Mapper: :~Mapper () 
{ 


if (fp) 
{ 
delete cMapperFileSpec ; 
close(fp) ; 


{ 

if (!fp) 
{ // get file location defaults: 
cMapperFileSpec = new char [strlen(cMap) + 13] ; 
sprintf (cMapperFileSpec, "%s\\MAPPER.DAT", cMap) ; 
// append if exists, otherwise create : 
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if (access(cMapperFileSpec, F_OK == -1)) 
{ 
FILE * fd = fopen(cMapperFileSpec, "wt") 
fcelose(fd) ; 
; 
if ((fp = sopen (cMapperFileSpec, 
O_RDWR, 
SH_DENYNO)) == -1) 
return -1 ; 
} 
return @ ; 
} 
|/------------------ Close----------------------------------- 
Mapper: :Close() 
{ 
if (fp) 
{ 
close(fp) ; 
fp=@; 
} 
return @ ; 
} 
|/------------------- LockSpot------------------------------- 
char * Mapper: :LockSpot () 


if (!fp) Open() ; 

1BytePosition = lseek(fp, @L, SEEK_END) ; 

WipeMapper() ; 

if (write(fp, &Map, sizeof(Map) ) == -1) 
return NULL ; 

lseek(fp, 1BytePosition, SEEK_SET) ; 

#ifndef NOLOCK 

// don't let anyone else append 

if (locking(fp, LK_LOCK, (long)sizeof(Map)) == -1) 
return NULL ; 

#endif 

sprintf (cBytePosition,"%8.81x", 1BytePosition) ; 

return cBytePosition ; 


J 
| |--------------------------- Read~--------------------------- 
char * Mapper::Read(long 10ffset) 
{ 
if (!fp) Open() ; 
if (lseek(fp, l0ffset, SEEK_SET) == -1) 
return NULL ; 
if (read(fp, &Map, 6 ) == -1) // device,dir, & extension 
return NULL ; 
sprintf(cBytePosition, "%8.81x", l0ffset); // filename 
sprintf (cMwholefilename, "%1.1s:\\%1.2s\\%8.8s.%3.35", 
Map.cDevice, // Image device 
Map.cPath, // Image path (or Jukebox disk) 
cBytePosition, // filename/offset in hex 


Map.cFileExtension ) ; // type (TIF,WP4,WP5...) 
return cMwholefilename; 


Mapper::Write(char * Extension,// Image type 
char * Path, // Image subdir or juke platter 
char * Device)// Image device (single letter) 
{ 
if (!fp) Open() ; 
memcpy((char *)&Map.cDevice, Device, 1) ; 


memcpy ((char *)&Map.cPath, Path, sizeof(Map.cPath)) ; 
memcpy ((char *)&Map.cFileExtension, Extension, 


sizeof (Map.cFileExtension)) ; 
return Write() ; 


Mapper: :Write() 


lseek(fp, 1BytePosition, SEEK_SET) ; 


if (write(fp, &Map, sizeof(Map) ) == -1) 
return -1 ; // should return error code here 
#ifndef NOLOCK 
if (locking(fp, LK_UNLCK, (long) sizeof(Map)) == -1) 
return - 1 ; // should return error code here 
#endif 
return @ ; 
} 
{i LINKED LIST METHODS 
//------------------------- constructor---------------------- 
LinkedList: :LinkedList () 
{ 
fp =@; 
Open() ; 
M = new Mapper(); 
} 
| /------------------------ oblivion-------------------------- 
LinkedList: :~LinkedList () 
{ 
if (fp) 
close(fp) ; 
delete M ; 
} 
|/------------------- open and close members----------------- 
LinkedList: :Open() 
{ 
int ok ; 
if (!fp) 
{ 


cLinkedListFileSpec = new char [strlen(cLinkL) + 13] ; 
sprintf (cLinkedListFileSpec,"%s\\LINKEDL.DAT", cLinkL) ; 
// append if exists, otherwise create : 


if (access(cLinkedListFileSpec, F_OK == -1)) 
{ 
FILE * fd = fopen(cLinkedListFileSpec, "wt") 
fclose(fd) ; 
if ((fp = sopen (cLinkedListFileSpec, 
O_RDWR, 
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SH_DENYNO)) == -1) 
return -1 ; 
1BytePosition = lseek(fp, @L, SEEK_END) ; 
// Write a -1 header because a '@' file name * -1 = 9 
11.Previous = 11.Next = @ ; 
11.MapperAddress = -1 ; 
1BytePosition = @ ; 
lseek(fp, 1BytePosition, SEEK_SET) ; 


if (write(fp, &11, sizeof(1l) ) == -1) 
return -1 ; 
return @ ; 


else // file already exists 
if ((fp = sopen (cLinkedListFileSpec, 
O_RDWR, 
SH_DENYNO)) == -1) 
return -1 ; 
} 
return @ ; 


} 


LinkedList: :Close() 
{ 
if (fp) 
{ 


delete cLinkedListFileSpec ; 
close(fp) ; 

fp = 90 ; 

} 


return @ ; 


| [== eneeemeemaetedas Last lmage=<<--<-=<93-4—<5452245--<-55 
char * LinkedList::LastImage(long 10ffset) 


{ 
Read(l0ffset) ; 
while (11.Next) 
Read(11.Next) ; 
return (M->Read(11.MapperAddress)) ; 


char * LinkedList::Read(long 10ffset) 


{ 

char lbuf [9]; 

char buffer[7]; 

if (l0ffset < 0) 
10ffset *= -1 ; 

1BytePosition = l0ffset ; 

if (!fp) Open() ; 

if (lseek(fp, 10ffset, SEEK_SET) == -1) 
return NULL ; 

if (read(fp, &11, sizeof(1l1) ) == -1) 
return NULL ; 

return (M->Read(11.MapperAddress) ) ; 


| | ener --------------- = LockSpot-------------------------9---- 
char * LinkedList: :LockSpot () 

if 

if (!fp) Open() ; 

1BytePosition = lseek(fp, @L, SEEK_END) ; 

11.Next = 11.Previous = @ ; 

if (write(fp, &11, sizeof(11) ) == -1) 

return NULL ; 
lseek(fp, 1BytePosition, SEEK_SET) ; 


#ifndef NOLOCK 

if (locking(fp, LK_LOCK, (long)sizeof(1l)) == -1) 
return NULL ; 

#endif 

M->LockSpot() ; 

11.MapperAddress = M->1MapSlot () 

return M->Hexbytes() ; 


LinkedList::Write(char * Extension, // Image type 
char * Path, // subdir or platter 
char * Device) 


{ 
if (!fp) Open() ; 
lseek(fp, 1BytePosition, SEEK_SET) ; 


if (write(fp, &11, sizeof(11) ) == -1) 
return -1 ; 
#ifndef NOLOCK 
if (locking(fp, LK_UNLCK, sizeof(11l)) == -1) 
return -1 ; 
#endif 
M->Write(Extension, Path, Device) ; 
return @ ; 
| /--------------------------- Write-------------------------- 


LinkedList: :Linkin(long LLPr) 


{ 

if (!fp) Open() ; 

lseek(fp, LLPr, SEEK_SET) ; 

if (read(fp, (char *)&11, sizeof(1l) ) == -1) 
return -1 ; 

lseek(fp, LLPr, SEEK_SET) 

11.Next = 1BytePosition ; 


if (write(fp, (char *)&11, sizeof(11) ) == -1) 
return -1 ; 

lseek(fp, 1BytePosition, SEEK_SET) ; 

if (read(fp, (char *)&11, sizeof(1l) ) == -1) 
return -1 ; 


lseek(fp, 1BytePosition, SEEK_SET) ; 

11.Previous = LLPr ; 

if (write(fp, &11, sizeof(1l) ) == -1) 
return -1 ; 

#ifndef NOLOCK 

if (locking(fp, LK_UNLCK, sizeof(1l)) == -1) 
return -1 ; 

#endif 
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return @ ; 


} 


e e 
Listing Three 
/* this program creates a Mapper.dat and LinkedL.dat and 
writes 1,000 single image entries and 1,000 entries of 4 page 
documents, then reads them back. The entries are stored in 
a sequential file as 4 byte character strings. */ 
char cKey[] = "C:\\MAPTEST\\KEYS.X" ; 
char cDev[{] = "X"; // where 'images' are stored 
const long TestCount = 1000 ; 
const int MultiPage = 4 ; // # Images in multipage docs. 
union value // converts 4 byte chars to long and visa-versa 
{ 
long 1Value ; 
char cValue[sizeof(long)] ; 
} uValue ; 
Mapper * Map ; 
LinkedList * LL ; 
char * AvailableMapper ; 
#include "stdlib.h" 
int main(int argc, char * argv[]) 
{ 
char cmd [32] ; 
FILE * fd ; 
int fp ; 
long i ; 
long lLong ; 
char szDir[3] ; 
sprintf(cmd, "DEL %s\\MAPPER.DAT", cMap) 


system(cmd) ; 

sprintf(cmd, "DEL %s\\LINKEDL.DAT", cLinkL) 
system(cmd) ; 

fd = fopen(cKey, "w") 

felose(fd) ; 


fp = open(cKey, O_WRONLY) ; 
Map = new Mapper ; 
itoa(1, szDir, 10) ; // make up directory names 
for (i = @; i < TestCount; i++) 
4 
Map->LockSpot() ; 
Map->Write("TIF", szDir, cDev) ; 
uValue.1Value = Map->1MapSlot() ; 
lseek(fp, @, SEEK_END) ; 
write(fp, (char *)&uValue.cValue, sizeof(long)) ; 
if ((i / 100) * 100 == i) 
{ 


itoa(i, szDir, 10) ; // change directory name 
printf("\t%ld", i) 
} 
delete Map ; 
close(fp) ; 
// Build some Multi-page: 
fp = open(cKey, O_RDWR) ; 
printf ("\nMulti-page Documents\n") 
LL = new LinkedList ; 
itoa(1, szDir, 10) ; // make up directory names 
for (i = @; i < TestCount; i++) 
{ 
LL->LockSpot() ; 
LL->Write("TIF", szDir, cDev) ; 
uValue.1Value = LL->1LinkSlot() ; 
uValue.1Value *= -1 ; // say we are a linked list entry 
lseek(fp, @, SEEK_END) ; 
write(fp, (char *)&uValue.cValue, sizeof(long)) ; 
lLong = LL->1LinkSlot() ; 
for (int j = 1; j < MultiPage; jt+) 
{ // next pages: 
LL->LockSpot() ; 
LL->Write("TIF", szDir, cDev) 
- LL->Linkin(lLong) ; 
lLong = LL->1LinkSlot() ; 


} 
if ((i / 100) * 100 == i) 
{ 


itoa(i, szDir, 10) ; // change directory name 
printf("\t%ld", i) ; 
} 
} 
close(fp) ; 
delete LL ; 
// we can read them all back now: 
Map = new Mapper ; 
LL = new LinkedList ; 
fp = open(cKey, O_RDONLY) ; // open the keys 
lseek(fp, @, SEEK_SET) ; 
printf("\n'Long'\tFilename\n") ; 
while (read(fp, (char *)&uValue.cValue, sizeof(long) )) 
{ 


if (uValue.1Value >= @) 
printf ("\n%1d\t%s", 
uValue.1Value, Map->Read(uValue.1Value)) ; 
else 


{ 
printf ("\n%1d\t%s", 
uValue.1Value, LL->Read(uValue.1Value)) ; 
while (LL->Next()) 
printf ("\n%ld\t%s", 
uValue.1Value, LL->Read(LL->Next())) ; 
} 


} 
close(fp) ; 
delete Map ; 
delete LL ; 
return @ ; 


} 


End Listings 
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Listing One (Zext begins on page 66.) 
DOWNLOAD 


\ Filename: 1bk332.f 

\ Author: jack j. woehr jax@well.UUCP JAX on GEnie SYSOP, RCFB (303) 278-0364 
\ Copyright (c) 1991, Vesta Technology, Inc. ALL RIGHTS RESERVED. 

\ Platform: SBC332 w/ VFSE Purpose: Primitives & exercise LBK332 board. 

\ Dependencies: Platform; W@ W! (16-bit ops) 


\ TRUE FALSE @<> from Core Extensions 

\ YREG332.F and QSM332.F must be loaded 

\ Some code meant to execute only in Supervisor mode. 

\ References: MC68332 USER'S MANUAL [MC68332UM/AD] Motorola, 1990 

\ GE Solid State Data Book SSD-26@C Printed 12-87 [GE-SSD] 
BASE @ 

HEX 


\ ** Utilities -- Kludgy delays, may have to be adjusted when PAUSE is 

\ implemented. Reason for this delay: 1) Receive RAM doesn't seem to be written 
\ yet even when SPI says it's done in the SPSR.SPIF register, and 

\ 2) This stuff seems to be too fast for the LCD display. 


:\20-MS ( --) 

2000 @ DO ( PAUSE) LOOP ; 
: 100-MS ( --) 

1@@®@@ @ DO ( PAUSE) LOOP ; 
\ ** Setting up for QSPI for the LBK332 
\ These routines can serve as models for other types of QSPI setup, though 
\ actual values, e.g., baud, int vects & int levels might be different in a 
\ different application. These are specific to CDP68HC68P1 used on the LBK332. 
\ [MC68332UM/AD] 5.4.3.1 Write first to set output state. Specifically, we had 
\ better make sure that the LBK332 Chip Select is not active (low) (PCS@/_SS). 
: QPDR-SETUP ( --) QPDR.PCS@/_SS QPDR TRUE SET-YREG ; 


\ [MC68332UM/AD] 5.4.3.3 
\ Then configure direction bits MISO input, PCS@ MOSI output 
: QDDR-SETUP ( --) 

QDDR.MISO QDDR FALSE SET-YREG 

QDDR.PCS@/_SS QDDR.SCK OR QDDR.MOSI OR QDDR TRUE SET-YREG 


[MC68332UM/AD) 5.5.4.6 
Init RAM 
: QSPI-RAM-INIT ( --) ; 


a as 


mae 


[MC68332UM/AD] 5.4.3 
: QPAR-BITS ( chip-sel-mask --) 
[ QPAR.PCS@/_SS QPAR.PCS1 OR QPAR.PCS2 OR QPAR.PCS2 OR ] LITERAL 


DUP ROT AND \ constrain chip select mask 

SWAP INVERT QPAR W@ AND \ NAND off CS bits in current reg mask 
OR \ OR in new chip select mask 
QPAR.MOSI QPAR.MISO OR OR’ \ OR in these bits 


QPAR W! \ store new mask 

\ [MC68332UM/AD] 5.5.4.1 .. Set up as master of 8 bit xfers, 2.1MHz, 

\ Data changes on leading edge, sampled on falling edge. 

: SPCRO-SETUP ( --) 
SPCRO.MSTR \ SBC332 is master 

8 >SPCR@.BITS LSHIFT OR \ CDP68HC68P1 is 8 bit xfers 

SPCRO.CPHA OR \ [GE-SSD] pg. 537 Fig. 3 

FF OR \ SPCRO.SPBR 33 KHz frequency (Table 5-9) 

SPCR® TRUE SET-YREG \ install mask register 


\ [MC68332UM/AD] 5.5.4.2 .. Set up but don't start up 
: SPCRi-SETUP ( --) 
SPCR1.DSCKL >SPCR1.DSCKL LSHIFT 
SPCR1.DTL OR SPCR1.SPE OR SPCR1 FALSE SET-YREG 
\ [MC68332UM/AD] 5.5.4.3 .. Reads to this register get actual reg contents, 
\ not necessarily last-written which latter is buffered during serial xfer, 
\ taking effect next xfer. We setup here for no interrupts, no wraparound, etc. 
\ Of course, application will change this ... this is just init, 
\ and is powerup default. 


: SPCR2-SETUP ( --) ® SPCR2 W! ; 


\ [MC68332UM/AD] 5.5.4.4 .. We don't need any of this stuff. 
: SPCR3-SETUP ( --) ® SPCR3 W! ; 


\ ** Setup of QSM in order prescribed by [MC68332UM/AD] 5.4.1 
: QSM-SETUP ( --) 

FALSE QSM-SUPERVISOR 

1 QSM-IARB! 

FALSE QSM-STOP 

FALSE QSM-FREEZE 

40 QIVR W! 

1 1 QSM-INT-LEVEL 

QPDR-SETUP 

QDDR-SETUP 

QSPI-RAM-INIT 

QPAR.PCS@/_SS QPAR-BITS 

SPCRO-SETUP 

SPCRi-SETUP 

SPCR2-SETUP 

SPCR3-SETUP 
\ Set QSPI a-runnin' 
: QSPI-START ( --) SPCR1.SPE SPCR1 TRUE SET-YREG ; 
\ Orderly QSPI shutdown 
: QSPI-SHUTDOWN ( --) 

SPCR3.HALT SPCR3 TRUE SET-YREG 

BEGIN ( PAUSE) SPSR W@ SPSR.HALTA AND @<> UNTIL 

SPCR1.SPE SPCR1 FALSE SET-YREG 
\ Clear a HALT condition 
: UNHALT ( --) SPCR3.HALT SPCR3 FALSE SET-YREG ; 
\ Return indicates of QSPI was inactive and thus able to conduct one two-byte 
\ transaction. Presumes only PCS@/_SS from among chip selects is assigned to 
\ QSPI; otherwise, command masks should contain states for other chip selects. 
: LBK332! ( ul u2 -- flag) 

SPCR1 W@ SPCR1.SPE AND @= 

IF 

TRAN-RAM 2 + W! 
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TRAN-RAM W! 
COMD-RAM.CONT COMD-RAM C! \ PCS@/_SS low 
® COMD-RAM 1+ C! \ ditto 
SPCR2.NEWQP FALSE SPCR2 SET-YREG 
[ 1 >SPCR2.ENDQP LSHIFT SPCR2.ENDQP AND ] 
LITERAL SPCR2 TRUE SET-YREG 
QSPI-START 
TRUE 
20-MS \ kludge delay for Receive RAM to get written 
ELSE 
2DROP FALSE 
THEN 


: QSPI-DONE? ( -- flag) 
SPSR W@ SPSR.SPIF AND @<> ; 
: QSPI-READY? ( -- flag) 
SPCR1 W@ SPCR1.SPE AND @= ; 
: WAIT-QSPI-DONE ( --) 
BEGIN ( PAUSE) QSPI-DONE? UNTIL ; 
: WAIT-QSPI-READY ( --) 
BEGIN ( PAUSE) QSPI-READY? UNTIL ; 


\ Constants for controlling the two CDP68HC68P1 chips, addressed 

\ @ and 1. Port @ is all outputs, except for KEY*. Port 1 is an output to 
\ write to the LCD, and an input to read the keypad. [GE-SSD] pp. 537-539 
@@ CONSTANT PORTO 

40 CONSTANT PORT1 

@ CONSTANT DATA-REG 

2@ CONSTANT DIR-REG 

@@ CONSTANT READ 

19 CONSTANT WRITE 

@®@ CONSTANT WRITE-BITS 

@8 CONSTANT RESET-BITS 

@C CONSTANT SET-BITS 


\ These only need to be set if you want to read the compare flag 
@@ CONSTANT ONE-NON-MATCH 

@1 CONSTANT ALL-MATCH 

@2 CONSTANT ALL-NON-MATCH 

@3 CONSTANT ONE-MATCH 


: PORT@-SETUP ( --) 
[ PORT@ DIR-REG WRITE WRITE-BITS OR OR OR ] LITERAL 
7F LBK332! DROP \ port @ all output except KEY* 


PORT1-IN ( --) 
[ PORT1 DIR-REG WRITE WRITE-BITS OR OR OR ] LITERAL 
@@ LBK332! DROP 

: PORT1-OUT ( --) 
[ PORT1 DIR-REG WRITE WRITE-BITS OR OR OR ] LITERAL 
FF LBK332! DROP 

: LBK332-CONFIG ( --) 
PORT@-SETUP PORT1-IN \ must be changed to write LCD 

\ ** IO Port Control 

\ Bits from Port @ 

@1 CONSTANT R/W* 

@2 CONSTANT ENLCD@ 


\ Read/Write for LCD Port 

\ 
@4 CONSTANT ENLCD1 \ 

\ 

\ 


R 
LCD @ Enable 
LCD 1 Enable 
CS for the 74HC541 which reads keypad 
Beeper enable 
\ RS for LCD .. D@ of Beeper pitch 
4 CONSTANT TONE1 \ n/a for LCD .. Di of Beeper pitch 
8@ CONSTANT KEY* \ Active low when there is a keypress 
5 CONSTANT TONE-SHIFT \ Shift for pitch bitmask 
\ Only reads data, discards compare mask. 
: PORT@@ ( -- u) 

WAIT-QSPI-READY 

[ PORT@ DATA-REG READ OR OR ] LITERAL 

DUP LBK332! DROP 

WAIT-QSPI-DONE 

REC-RAM 2 + W@ 


@8 CONSTANT ENKEY* 
1@ CONSTANT ENBEEP* 
20 CONSTANT TONE@/RS 


\ Writes data 

: PORTO! ( u --) 
WAIT-QSPI-READY 
[ PORT@ DATA-REG WRITE WRITE-BITS OR OR OR ] LITERAL 
SWAP LBK332! DROP 


\ sets data 

: PORT@-SET! ( u --) 
WAIT-QSPI-READY 
[ PORT® DATA-REG WRITE SET-BITS OR OR OR ] LITERAL 
SWAP LBK332! DROP 


\ resets data 

: PORT@-RESET! ( u --) 
WAIT-QSPI-READY 
[ PORT@ DATA-REG WRITE RESET-BITS OR OR OR ] LITERAL 
SWAP LBK332! DROP 


\ Only reads data, discards compare mask. 
: PORT1@ ( -- u) 
WAIT-QSPI-READY 
[ PORT1 DATA-REG READ OR OR ] LITERAL 
DUP LBK332! DROP 
WAIT-QSPI-DONE 
REC-RAM 2 + W@ 


\ Writes data 

: PORT1! ( u --) 
WAIT-QSPI-READY 
[ PORT1 DATA-REG WRITE WRITE-BITS OR OR OR ] LITERAL 
SWAP LBK332! DROP 


** Keypad Control -- Enable, disable keypad reader. Necessary so that keypad 
data doesn't trash LCD writes. 
: KEYPAD-ENABLE ( --) ENKEY* PORTQ-RESET! ; 


a --: 


(continued on page 108) 
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Problem. 


One. 
YOu. 


Wont. Experience. 
Debugging. C. Code. 
With. Our 
Windows-based. 
Real. Time. Emulators. 


Put an end to frustrating 
interruptions with 

HP’s Real-Time C debugger 
for PCs. 


Sure, now that some emulators are 
offering Windows interfaces, your 
debugging problems might appear 
to be solved. But what good is an 
easy-to-use graphical interface if 
you have to interrupt the operation 
of your target system every time 
you debug? 


That’s where the new PC-based HP 
64700 Series Real-Time C Emulator 
User Interface comes in. It offers a 
true combination of C debug and 
real-time emulation capability, 


along with the MS-Windows you're 
comfortable using. So you can 
easily debug your design while it’s 
running at full speed, allowing you 
to focus on real problems. Instead 
of chasing after phony ones. 


Call your local HP sales office or 
one of the numbers listed below for 
free literature. 


And start using a design tool that 
won't stop your design process. 


There is a better way. 


G 


HEWLETT 
PACKARD 


CIRCLE NO. 840 ON READER SERVICE CARD 


© 1993 Hewlett-Packard Co. TMCOL316/INTL 


EMULATORS 


MOTOROLA 


68000/EC000 68331/332 68030/EC030 
68HC00/001 68340 68040/EC040* 
68302 68020/EC020  68LC040* 


*Now with MMU, Cache, and bus snooping support. 


80960SA/SB 80C186EB 80C86/88 
80960KA/KB 80C186EC 800186/188 
80C186EA 80C186XL 80286/C286 
With support for Microsoft and Borland compilers. 


*All Intel products are U.S. trademarks of Intel Corporation. 


PLATFORM SUPPORT 


HP 9000 Series 300, 400 & 700 

Sun Microsystems SPARCstations 

IBM PC Compatibles 

(1) Also support for AMD, Texas Instruments, Zilog, 


National Semiconductor, NEC, Hitachi and Mitsubishi; 
call for more information. 





Australia (008) 033-821 * France (1-69) 82-65-00 * Germany (06172) 16-1634 * Hong Kong (852) 848-7070 © India (11) 463-2379 « Italy (02) 9212-2241 ¢ Korea (2) 769-0800 * Netherlands (020) 547-6669 
PRC (1) 505-3888 ¢ Singapore (65) 291-8554 ¢ Spain (900) 123-123 « Sweden (08) 750-20-00 ¢ Switzerland (057) 31-21-11 ¢ Taiwan (2) 717-9524 ¢ United Kingdom (0344) 362-867 


MS-DOS ROM 5.0 


LICENSES FOR EMBEDDED PCs 


Microsoft has contracted with Annebooks to provide 
MS-DOS licenses to the embedded application market. 
Now, industry giants, small developers, and everyone in 
between can build MS-DOS 5.0 into their embedded 
systems and have the economy and convenience of 
licensing from Annabooks. We also license 
Windows, if you want! And our simple four-page 
licensing agreement can be sent by fax, to save time. 


Our MS-DOS ROM Version 5.0 Developer's Kit gives 
you unprecedented flexibility in adapting this powerful 
version of MS-DOS to your application. Many of the 
files include source code you can modify. This version 
of MS-DOS 5.0 runs in ROM, using only about 17K of 
The developer's kit also 





RAM after the initial boot. 
includes Power Management and PCMCIA drivers. 


We can help you with both disk-based and ROM- 
based applications. We have other MS-DOS versions 
available, as well as a kit for the MS Flash Memory File 
System. For more information, call us today. 

Our job is helping you find the answers! 


ANNABOOKS 


15010 Avenue of Science, Suite 101 
San Diego, CA 92128 


MS-DOS and Windows are Trademarks of Microsoft Corp. 


CIRCLE NO. 394 ON READER SERVICE CARD 


TURN YOUR PC INTO A SOPHISTICATED, 
EASY TO USE, SERIAL COMMUNICATIONS 
| PROTOCOL ANALYZER ; 

_) “MAKE THE CONNECTION’... $395" ( \H 


@ CAPTURE & 
TRANSMIT 
DATA 


@ EGA/VGA FONT 


REPLACEMENT 
V1.01 $395 V2.01 $495 


© use OR - PROGRAMMABLE 
RTCARD USING BUILT IN “C” 
COMPILER AND EDITOR 


RTCARD' 


INTELLIGENT SERIAL 
COMMUNICATIONS ¢39500 


e SYNC / ASYNC ¢ 80C31 uP 
¢ 32K RAM ¢ 85C30 MPCC 


USE OUR DRIVER SOFTWARE ... 
OR DOWNLOAD YOUR OWN CODE 


RTX485 


RS-232 TO 
RS-422/485 
CONVERTER 


919500 


@® DAIA TO & 
FROM DISK 


® uSECOND 
TIMING 


@ HEX/ASCII 
EBCDIC 


@ PRINTF 








REALTIME 
CONTROL, INC. 


P.O. Box 140370 
Gainesville, FL 32614-0370 


(800) 232-0485 (904) 373-2626 


CIRCLE NO. 520 ON READER SERVICE CARD 
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Listing One (Listing continued, text begins on page 66.) 


: KEYPAD-DISABLE ( --) ENKEY* PORT@-SET! ; 


\ 


Is a key currently pressed? 


: PKEY? ( -- flag) PORT®@@ KEY* AND @= ; 


\ 
\ 


@PKEY returns a mask in which D@-D2 are octal row and D3-D5 are octal column. 
The mask is only valid if KEY* is currently reading HI 


: @PKEY ( -- mask) 


a -_-- 


PORT1-IN KEYPAD-ENABLE PORT1@ KEYPAD-DISABLE 


** LCD Control -- Delays may have to be written into these LCD words 
depending upon serial clock rate. 


: LCD@-CMD! ( u --) 


: LCDO-DATA! 


KEYPAD-DISABLE 

PORT1-OUT PORT1! 

R/W* PORT@-RESET! 

TONE@/RS PORTO-RESET! 

ENLCD@ PORTO@-SET! 

ENLCD@ PORTQO-RESET! 

100-MS \ kludge delay for slow LCD 


{A =e) 

KEYPAD-DISABLE 

PORT1-OUT PORT1! 

R/W* PORTQ-RESET! 

TONEQ/RS PORTQ-SET! 

ENLCD® PORT@-SET! 

ENLCD®@ PORT@-RESET! 

100-MS \ kludge delay for slow LCD 


: LCD1-CMD! ( u --) 


KEYPAD-DISABLE 

PORT1-OUT PORT1! 

R/W* PORT@-RESET! 

TONE@/RS PORT@-RESET! 

ENLCD1 PORTO-SET! 

ENLCD1 PORT@-RESET! 

100-MS \ kludge delay for slow LCD 


: LCD1-DATA! ( u --) 


oe "we 


KEYPAD-DISABLE 

PORT1-OUT PORT1! 

R/W* PORTO-RESET! 

TONE@/RS PORT@-SET! 

ENLCD1 PORTO-SET! 

ENLCD1 PORTO-RESET! 

100-MS \ kludge delay for slow LCD 


**k Generic LCD@ Stuph ... RTFM if this doesn't work 
LCD@-HOME ( --) @2 LCD@-CMD! ; 


: LCD@-CLEAR ( --) @1 LCD@-CMD! ; 
: LCDQ-INIT ( --) 


38 LCD@-CMD! 
OF LCD@-CMD! 
LCD@-HOME 
LCD@-CLEAR 


LCD@-TYPE ( c-addr u --) 


a lt 


ee ee we 


OVER + SWAP ?D0 I C@ LCD@-DATA! LOOP ; 
*k Beeper 
Deactivate the #@$!* beeper 
UNBEEP ( --) PORT@@ ENBEEP* OR PORTO! 
Beep at pitches @ - 3 
BEEP ( u --) 
4 MOD TONE-SHIFT LSHIFT 
PORT@@ [ TONE@/RS TONE1 OR ] LITERAL INVERT AND 
OR ENBEEP* INVERT AND PORTO! 


**k Initialize 
LBK332-SETUP ( --) QSM-SETUP PORTQ-SETUP ; 
** Quicky Test 
TEST-LBK332 ( --) 
LBK332-SETUP LCD@-INIT 
BEGIN 
BEGIN UNBEEP PKEY? EKEY? OR UNTIL 
PKEY? 
IF 
LCD@-HOME LCDQ-CLEAR 
@PKEY 
1F AND DUP 3 RSHIFT 
DUP 4 MOD BEEP 
5S" Row: " LCDQ-TYPE 
30 OR LCDQ-DATA! 
7 AND 30 OR 
DUP 4 MOD BEEP 
S" Column: " LCD@-TYPE 
LCD@-DATA! 
BEGIN PKEY? @= EKEY? OR UNTIL 
ELSE 
KEY DROP UNBEEP EXIT 
THEN 
AGAIN 


BASE ! 
END-DOWNLOAD 


Listing Two 


DOWNLOAD 


\ Filename: qsm332.f 

\ Author: jack j. woehr jax@well.UUCP JAX on GEnie SYSOP, RCFB (303) 278-0364 
\ Copyright (c) 1991, Vesta Technology, Inc. ALL RIGHTS RESERVED. 

\ Platform: SBC332 w/ VFSE 

\ Purpose: Defines and primitives for SBC332 Queued Serial Modul (QSM) 

: Dependencies: Platform board; VFSE-332 operators W! W@ (16-bit ops). 


Needs: YREG332.F 


\ References: MC68332 USER'S MANUAL [MC68332UM/AD] Motorola, 1990 


(continued on page 110) 
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QUICK AND EASY 


Many leading C and C++ embedded 
systems software developers have come to 
appreciate the quick, easily accessible, 
push-button control they get from XRAY 
MasterWorks... 


"The user interface is consistent and 
easy to get around. You can very 
easily put things together. I've used 
the on-line help and it's very handy. 
Good project management tool.” 

Mark Bryan ("MB") KORG R&D 


Since MasterWorks is a complete 
programming environment, that control 
extends across the entire range of tasks 
you perform, day in and day out, including 
program building, code generation, debug- 
ging and analysis. 


It's that tight integration of tools that 
enables MasterWorks users to achieve 
new levels of efficiency in their edit- 
compile-debug processes .. . 


"The tools we've come to know and 

love are all still there. Now we have 

the convenience of a GUI interface." 
Joel Wilhite ("JW"), RAYNET Corporation 


A COMPLETE PACKAGE 


XRAY MasterWorks is a complete package 
of productivity-enhancing components, 
including... 

XRAY Master, which provides an environ- 
ment manager, control panel, automatic 
make, object format converter, and Source 
Explorer — for fast comprehension through 
graphical displays of structure... 


"| have to validate code paths. That's 
where Source Explorer comes in 
handy. It's also good for new 
employees who have to learn the 
code... fast." -JW 





XRAY MasterWorks users get 
push-button control 


Plus XRAY Debugger — which displays 
multiple windows simultaneously, and the 
industry-standard Microtec Research C 
and C++ cross compilers — with macro 
assembler, linker, and librarian. 


"All the separate code, registers, 
and data windows really make a lot 
of sense. | couldn't be happier 

with it." -JW 


SEE FOR YOURSELF 


Since 1974, Microtec Research has set the 
standard in programming tools for 
embedded systems developers. XRAY 
MasterWorks is the next logical step in 
that evolution. 


To see for yourself just what push-button 
control can mean to you, contact your local 
Microtec Research office and ask for a 
MasterWorks evaluation... 


"When we evaluated it, we saw 
how XRAY MasterWorks could save 
us time."-MB 


CALL 1-800-950-5554 


CIRCLE NO. 616 ON READER SERVICE CARD 


Microtec 
Research 


Setting the Standard 





UK and Europe +44 256 57551 e France (33) 1-30-57-19-09 ¢ Germany, Austria, and Switzerland (49) 089/609 60 20 ¢ Japan (81) 3-5210-3050 ¢ Scandinavia +46-8-744 53 00 
Microtec, the Microtec logo, and XRAY are registered trademarks of Microtec Research, Inc. 
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Listing Two (isting continued, text begins on page 66.) 


\ $Log: V:/vestasrc/forth/68332/tpuqsm/vces/qsm332.f_v $ 
Rev 1.1 14 Jul 1992 11:26:26 jax 

\ cleanup edits 

\ Rev 1.0 17 Jun 1992 10:09:26 jax 


\ Initial revision. 
Check us out for the best \ : Peel and bits from MC68332UM/AD Tables 5-1 and 5-2. 
Optical Character Recognition ace 
accuracy and the highest FECOO YREC ICR 
speed on the market. 4000 CONSTANT GMCR.FRZ1 


2000 CONSTANT QMCR.FRZ@ 
8 CONSTANT QMCR.SUPV 
OF CONSTANT QMCR.IARB \ field, not bit mask 
FFC@2 YREG QTEST \ Not used in VFSE-332 


True 32 bit OCR engine \ 
F 7 \ 08 CONSTANT QTEST.TSBD 
Omnifont: 6 to 72 points \ 4 CONSTANT GEST. SYNC 
\ 


@2 CONSTANT QTEST.TQSM 
@1 CONSTANT QTEST.TMM 


Embedded spellchecker FFCO4 YREG QILR —-\ 8 msbs 
\ FFC@5 YREG QILR \b dd , but SET-YREG W@ W! 
Outputs ASCII & RTF 3800 CONSTANT QILR-ILQSPI\ ficla ~ 
QB CONSTANT >QILR.ILQSPI \ bit shift 
70@ CONSTANT QILR.ILSCI \ field 
8 CONSTANT >QILR.ILSCI \ bit shift 


OCR Library and API Tool Kit eae ae | Wcuhes 
Available for Windows, OS/2, WEE? ane ap eRrEY 
° FFC@8 YREG SCCR@ 
Macintosh & UNIX. 1FFF CONSTANT SCCRQ.SCBR \ field 
FFC@A YREG SCCR1 
Fully featured end-user version ee int oe i 
available for evaluations. 1000 CONSTANT SCCR1. ILT 


80@ CONSTANT SCCR1.PT 
40@ CONSTANT SCCR1.PE 


200 CONSTANT SCCR1.M 
| - 10@ CONSTANT SCCR1.WAKE 
82 CONSTANT SCCR1.TIE 


TECHNOLOGY 4Q CONSTANT SCCR1.TCIE 
2@ CONSTANT SCCR1i.RIE 
A i 1@ CONSTANT SCCR1.ILIE 
Larkspur, California ee 


Phone Fax CONSTANT SCCR1.RWU 
415.925.2323 415.461.4010 ae 


100 CONSTANT SCSR.TDRE 
CIRCLE NO. 857 ON READER SERVICE CARD eee 
20 CONSTANT SCSR.RAF 
1 CONSTANT SCSR.IDLE 
8 CONSTANT SCSR.OR 
4 CONSTANT SCSR.NF 
2 CONSTANT SCSR.FE 
1 CONSTANT SCSR.PF 
FFC@E YREG SCDR 
100 CONSTANT SCDR.R8/T8 
80 CONSTANT SCDR.R7/T7 
40 CONSTANT SCDR.R6/T6 
20 CONSTANT SCDR.R5/T5 
10 CONSTANT SCDR.R4/T4 
CONSTANT SCDR.R3/T3 
CONSTANT SCDR.R2/T2 
CONSTANT SCDR.R1/T1 
CONSTANT SCDR.RG/TO 
\ FFC1@ YREG RESERVED 
\ FFC12 YREG RESERVED 
FFC14 YREG QPDR \ 8 lsbs only .. 8 msbs reserved 
80 CONSTANT QPDR.TXD 
40 CONSTANT QPDR.PCS3 
20 CONSTANT QPDR.PCS2 
10 CONSTANT QPDR.PCS1 
8 CONSTANT QPDR.PCS@/_SS 
4 CONSTANT QPDR.SCK 
2 CONSTANT QPDR.MOSI 
1 CONSTANT QPDR.MISO 
FFC16 YREG QPAR \ 8 msbs 
\ FFC17 YREG QPAR \ byte address, but SET-YREG uses W@ W! 
4000 CONSTANT QPAR.PCS3 
2000 CONSTANT QPAR.PCS2 
1000 CONSTANT QPAR.PCS1 
80@ CONSTANT QPAR.PCS@/_SS 
200 CONSTANT QPAR.MOSI 
100 CONSTANT QPAR.MISO 
FFC16 YREG QDDR \ 8 lsbs 
80 CONSTANT QDDR.TXD 


8 
4 CONSTANT SCCR1.RE 
y, 
1 





RPh & CO 





Save your lost profits with SecuriKey Ad CONSTANT QDDR.PCS3 
ues H hardw de 4 that 10 CONSTANT QDDR.PCS1 
a Unique vare vice 8 CONSTANT QDDR.PCS@/_SS 
prevents unauthorized use and 4 CONSTANT QDDR.SCK 
H 1 CONSTANT QDDR.MISO 
duplication of computer software. vrcte wen NSN 
‘ ‘ 80@@ CONSTANT SPCR®.MSTR 
e IBM, compatible & Macintosh 4000 CONSTANT SPCR@.WOMQ ; 
. ° “ 3C@@ CONSTANT SPCR@.BITS field 
e Allows unlimited backup copies micro QA CONSTANT >SPCRO.BITS  \ shift 
Can record software usage yecerne, ing. pices steerer evict | 
Available in custom colors & logos] 150 Wright Brothers | | .0., tere spon PER Feld 
. : Dr., Suite 560 8002 CONSTANT SPCR1.SPE 
Variety of programmable options Salt Lake City, 7F@@ CONSTANT SPCR1.DSCKL : field 
, @8 CONSTANT >SPCR1.DSCKL shift 
UNIX/XENIX Utah 84116 
FAX (801) 575-6621 


(continued on page 112) 
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: Trademarks are property of their respective holders CIRCLE NO. 835 ON READER SERVICE CARD 





68332 
VERSION 2.0 NOW SHIPPING 






The Complete C Communications Toolkit! 


MagnaeComm C has earned a reputation as the 
complete communications toolkit for C program- 
mers by supporting nearly every type of product 
and program. Now, MagnaeComm C version 2.0 
offers even more power and support. Created by 
professionals, for professionals, MagnaeComm C is the fast and easy way to add 
complete serial communications to any application. 


SPEED: Up to 115,200 bps FLOW CONTROL: XON/XOFF, RTS/CTS, DTR/DSR. MODEM 
SUPPORT:Full Hayes Command Set plus Telebitand UDS extensions. INTERRUPTS: 
receive, transmit, modem status, line status. TERM/NAL EMULATION: Televideo 
910/912/925, VT52, VT100, ANSI X3.64, ANSI.SYS. FAX SUPPORT: full DCA/Intel CAS 
support (fax and file transfer). All terminal emulations are supported under Win- 
dows. FILE TRANSFER: Complete support for single and multi file transfer. CH/P 
SUPPORT: Supports all popular communication chips. SERIAL PORTS: Supports 
and unlimited number of serial ports. DOCUMENTATION: Extensive 600-page manual 
with 125 pages of serial communications background, over 35 example programs. 


NEW MAGNA*eCOMM C V2.0 FEATURES: 

COMPUSERVE SUPPORT: Support for the complete CompuServe B File Transfer 
Protocol Suite. VETWORK MODEM SUPPORT: Complete network support... use a 
modem on a network from any workstation, even use a network modem directly 
from Windows! NEW DIAGNOSTICS: Use to determine if devices can share 
interrupts. ENHANCEMENTS: Enhanced control of file transfers; enhanced data 
transformation options. COMPATIBILITY: Compatible across DOS and Windows 
versions, use the same Magna*eComm C calls in DOS and Windows. 


ONLY $229 (US) MAGNA*COMM C FOR DOS (PLus SHIPPING) 





Listing Two (Listing continued, text begins on page 66.) 


FF CONSTANT SPCR1.DTL \ field 
FFC1C YREG SPCR2 
8000 CONSTANT SPCR2.SPIFIE 
4900 CONSTANT SPCR2.WREN 
29@@ CONSTANT SPCR2.WRTO 
FQQ CONSTANT SPCR2.ENDQP \ field 
@8 CONSTANT >SPCR2.ENDQP \ shift 
@F CONSTANT SPCR2.NEWQP \ field 
@@ CONSTANT >SPCR2.NEWQP \ shift 
FFC1E YREG SPCR3 \ 8 msbs 
\ FFC1F YREG SPCR3 \ byte address, but SET-YREG uses W@ W! 
400 CONSTANT SPCR3.LOOPQ 
200 CONSTANT SPCR3.HMIE 
10@ CONSTANT SPCR3.HALT 
FFC1E YREG SPSR \ 8 Isbs 
8@ CONSTANT SPSR.SPIF 
40 CONSTANT SPSR.MODF 
2@ CONSTANT SPSR.HALTA 
@F CONSTANT SPSR.CPTQP \ field 
\ FFC2@ YREG RESERVED \ YFFC2® - YFFCFF 
FFD@@ YREG REC-RAM \ YFFD@@ - YFFD1F 
FFD2@ YREG TRAN-RAM \ YFFD20 - YFFD3F 
FFD4@ YREG COMD-RAM \ YFFD4@ - YFFD4F 
8 CONSTANT COMD-RAM. CONT 
49 CONSTANT COMD-RAM. BITSE 
2@ CONSTANT COMD-RAM. DT 
1@ CONSTANT COMD-RAM.DSCK 
08 CONSTANT COMD-RAM.PCS3 
@4 CONSTANT COMD-RAM.PCS2 
@2 CONSTANT COMD-RAM.PCS1 
@1 CONSTANT COMD-RAM.PCS@/_SS 
\ ** QSM Functionality 
\ *%* [MC68332UM/AD 5.4.2.1] 
\ TRUE stops, FALSE enables QSM. Supervisor mode only. 
: QSM-STOP ( flag --) 

































MagnaeComm C for Extended DOS -$299 (US) COMPLETE \ pgiGR; STOP QMCR ROT SET-YREG . , fee eas 
Wi : : o avoid complications at restart & prevent data corruption, first disable 
Magna*Comm C for MS Windows $299 (US) SOURCE CODE \ all submodules: SCI rx/tx should be disabled, and operation completion 
Magna*Comm C Professional Combination - $499 (US) INCLUDED \ verified before asserting STOP. QSPI submodule should be stopped by asserting 
: : : ~ FREE ~ \ SPCR3.HALT and asserting STOP after HALTA flag set. TRUE causes QSM to HALT 
For ordering and information call toll free \ on transfer boundary when FREEZE asserted on IMB, FALSE causes QSM to ignore 






\ said signal. FREEZE is asserted when 332 enters the background mode. 
: QSM-FREEZE ( flag --) 
QMCR.FRZ1 QMCR ROT SET-YREG ; 
\ TRUE sets QSM supervisor-only access, FALSE (from supervisor mode, 
\ of course, resets to QSM user access permitted. 
: QSM-SUPERVISOR ( flag --) 
QMCR.SUPV QMCR ROT SET-YREG ; 
\ @ causes 332 to view QSM int as spurious, 1 (lo) to 15 (hi) are 
\ interrupt arbitration priority levels. 
: QSM-IARB! ( 0-15 --) 





Major credit cards accepted 


LICENSING 
1-800-755-7344 vey | 










Distributed by. SofDesign International, Inc. 
1303 Columbia Dr., Suite 209 Richardson, TX 75081 USA 
Voice: (214)644-0098 © FAX: (214)644-4286 


Supports MSC 5.0+/Quick C, Borland Turbo v2.0+, Watcom C. 











QMCR.IARB AND \ acceptable values @ - 15 

QMCR W@ \ fetch reg contents 
CIRCLE NO. 807 ON READER SERVICE CARD QMCR.IARB INVERT AND \ mask off IARB bits 

OR \ OR in desired mask 

QMCR W! \ store reg 





\ *#* [MC68332UM/AD 5.4.2.2] is for when MCU is in test mode. 


\ Not used in Vesta Forth Standard Edition 
\ *** [MC68332UM/AD 5.4.2.3] 
\ Int levels 0-7; if same, QSPI given priority. 
od : QSM-INT-LEVEL ( QSPI-level SCI-level --) 
a ect >QILR.ILSCI LSHIFT QILR.ILSCI AND \ shift @-7 mask and constrain 
ii SWAP 
>QILR.ILQSPI LSHIFT QILR.ILQSPI AND \ ditto 
OR \ form combination desired mask 
manavem ent QILR We ee ree 
QILR.ILQSPI QILR.ILSCI OR INVERT AND \ mask off IL fields from reg 
cis — OR \ OR in desired mask 
(| : QILR W! \ store reg 
Ma eC Cdsy \ *&* [MC68332UM/AD 5.4.2.4] 
\ Int vectors for QSPI/SCI are adjacent; bit D®@ of int vect is ® for SCI 
; \ and 1 for QSPI. 


: QSM-INT-VECTOR ( vector --) 
QIVR.INTV AND QIVR W! ; 
*** [MC68332UM/AD 5.4.3] 
In general, bit assignments can be handled directly by the application 
using SET-YREG from YREGS322.F 


with 

Defect Control 
oystem 

for Windows 


OO AO a 


BASE ! 
END-DOWNLOAD 


End Listings 





The award-winning defect manager Call now for your free demo disk and 


that organizes and monitors bug product information: 719-598-3713 
reports. 


Robust query and report facilities 
help you deliver quality software 
on time. 


Notification features and change ’ 

histories keep your team informed. SOFTWARE. a DG! A 
: ee The Leader in Defect Management 

Easy customization means DCS 


won't change the way you work. 4420 Laven Way 
Colorado Springs, CO 80920 


Slelz 
Slo 
S18 
< 
5 
= 
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Listing One (Text begins on page 72.) 


me A A of 2A 92 9 29 9 OR of 2 2 2 2 22 fe 2 2 9 2 2A OA 2 OK OK OK OK 


TYPES. ADS 
A copyright-reserved, free use program. 
(c)John H. McCoy, 1993 


-- Sam Houston St. Univ., TX 77341-2206 
aR HAH HCG RR ROR RoR AR ACC KK RoR oR oo of of 9K ko Ko ok ok 2K ok 2K 2k ak 


with system, memory; 
with unchecked_conversion; 


package Types is 


type byte is range @..255; 
type word is range @..65_535; 


The following types and functions are declared for use 
instead of integer, and system.address to avoid "align- 
ment holes" in record declarations. This may not be a 


problem with other than Meridian's implementation of ADA. 


type bytes is array (word range <>) of byte; 

type words is array (word range <>) of word; 

subtype W is bytes(1..2); 

subtype DW is bytes(1..4); 

function W_to_Word is new unchecked_conversion(W, Word) ; 

function DW_to_SA is new unchecked_conversion(DW, system.address) ; 
function DW_to_Long is new unchecked_conversion(DW, Long_Integer) ; 
function Word_to_W is new unchecked_conversion(Word, W); 

function SA_to_DW is new unchecked_conversion(system.address, DW); 
function Long_to_DW is new unchecked_conversion(Long_Integer, DW) ; 


subtype string8 is string(1..8); 
subtype string16 is string(1..16); 


function "+"(left, right: byte) return byte; 
function "OR"(left, right: byte) return byte; 
function "+"(left, right: word) return word; 
function "OR"(left, right: word) return word; 
function "+"(left, right: W) return W; 
function "OR"(left, right: W) return W; 


end Types; 


BACK ISSUES 


To order your back issues of DR. DOBB'S JOURNAL, 
call now: 


(800) 444-4881 


Mail Orders: P.O. Box 105448, Atlanta, GA 30348-5448 
Copies are $7 each, Canada and Mexico $9.00. 
Other International copies are $11. 

Call for volume discount prices. 
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Listing Two 


TTT TTT TTT T Ett Le ee eee 


— DRIVERS.ADS Excerpted Listing 

—- A copyright-reserved, free use program. 

— (c)John H. McCoy, 1993, Sam Houston St. Univ., TX 77341-2206 
SESS SISA ISSA ISI ISSO ISIS I aA IG I II ICI I IOI I IG IR I I I a A 1 i 2 1 A 1 A I I ACH A AIC OK OOK 
with system, memory, unchecked_conversion; 

with Types; use Types; 


package drivers is 


type DEV_CommandCodes is new byte; 
DeviceReadLong : constant DEV_CommandCodes := 128; 
type DEV_ReturnCodes is new W; 
DeviceDone : constant DEV_ReturnCodes := Word_to_W(16#0100#) ; 
type rhloctlIns is record 
Status : DEV_ReturnCodes; 
reserved : bytes(6..13); 
MediaDesc : byte; 
CBPtr : DW; 
TransferCount : W; 
Start : W; 
VolIdPtr : DW; 
end record; 
type rhXs (Command: DEV_CommandCodes := DeviceReadLong) is record 
case Command is 
when DeviceInit => Init : ghinits: 
when DeviceloctlInput => JToctlIn : rhlIoctlIns; 
when DevicelIoctl0Output ToctlOut: rhIoctlOuts; 
when DeviceReadLong | 
DeviceReadLongPrefetch 
when DeviceSeek => Seek 
when others => Other 
end case; 
end record; 
type rhs is record 
Length : byte; 
SubUnit : byte; 
rhX : rhXs; 
end record; 
subtype pkts is bytes(1..rhs’size/8) ; 


ReadLong: rhReadLongs; 
: rhSeeks; 
: rhOthers; 


function Rhs_to_Pkts is new unchecked_conversion(Rhs, Pkts) ; 
function Pkts_to_Rhs is new unchecked_conversion(Pkts, Rhs) ; 
end drivers; 


End Listings 








ste she 
APC/KDR DLL | Teinet DLL FTP DLL NetWin DLL | 
(ie) 


Berkeley Sockets Kernel (TCP, UDP, IP, ICMP) DLL SLIP/PPP 


===" \ 
for Windows — 


Windows Sockets, Berkeley Sockets Kernel, 
FTP. RPC/XDR, and Telnet toolkits ... all in one 


100% DLL (uses only 4K DOS memory) 


Uses much less memory than any other DLL or 
TSR implementation even when loaded 


Up to 128 concurrent sockets 


Coexists with Novell, Banyan or LAN Manager 
at no additional cost 


Supports NDIS, ODI and Packet drivers; SLIP 
and PPP with scripting 


TCP Tools: FTP (drag and drop), TFTP. Telnet, 
LPR/LPD, Back-Up with TAR and Monitor 


re (NE 
distinct 
408.741.0781 | 


CIRCLE NO. 838 ON READER SERVICE CARD 

















+ + HF HH H 


fastfacts: 408.867.4742 
fax: 408.741.0795 
email: mktg@distinct.com 
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EXAMINING 


Listing One (Text begins on page 84.) 


#include <stdlib.h> 
#include <stdio.h> 
#include <math.h> 
#include <string.h> 
#include <windows.h> 
#include "TvTypes.h" 
#include "Tv.h" 
#include "windemo.h" 


#define MAX_OVERLAYS 8 
#define MAX_ARGS 10 


struct WinEvent 
{ 
HWND hWnd; 
int code; 
ant =x: 
int y; 
ys 


DOUBLE zoom_factor = 2.0; 

file *companies; 

int grid_up = @, overlays = @, first_screen = 1, curshow, stat; 
char txtbuf [132] ; 

TvWindowID nowin; 

TvMapID map; 

HANDLE hInst, hAccTable; 


static DOUBLE proj_data[16]; 


static LONG proj_type = Q; 

static TvOverlayID overlay_user[MAX_OVERLAYS], overlay_tmp = Q, 
locator = 9, grid = @, 
compass =@, scale = @Q; 

int PASCAL WinMain( HANDLE, HANDLE, LPSTR, int ); 

BOOL InitTvApplication( HANDLE ); 

TvWindowID InitTvWindow( VOID ); 


LONG FAR PASCAL TV_process( HWND, UINT, WPARAM, LONG ); 
BOOL FAR PASCAL Tv_About( HWND, UINT, WORD, LONG ); 


De ROO OO GOSS OOO GG ORIG IG GO GGG GGG GGG GR IK a Rk ak a 
This is a standard WinMain function that initializes the appropriate Windows 
variables and checks and interprets the command line. 

USAGI OOO COSCO OSA OR ORG GG GRO RRA AG RR RK Kak ka aK / 

int PASCAL WinMain( hInstance, hPrevInstance, lpCmdLine, nCmdShow ) 

HANDLE hInstance; 

HANDLE hPrevInstance; 


LPSTR IlpCmdLine; 

int nCmdShow; 

{ 

TvWindowID win; 

MSG msg; 

LONG i, atol(); 

int arge = Q; 

char argv [MAX_ARGS], cmdline[80], *cp1, *cp2; 


if ( !hPrevInstance ) 
if ( !InitTvApplication( hInstance ) ) 
return( (int)NULL ); 
hInst = hInstance; 
curshow = nCmdShow; 


strepy( cmdline, "tv" ); 
argv[@] = cmdline; 
argcett; 


for( cpl = &emdline[strlen(cemdline)+1], cp2=1pCmdLine; 
*cop2 && (arge <= MAX_ARGS) ; 
) 


argv[ arge++ ] = cpl; 

while( *cp2 && (*cp2 !=' ') ) 
*epit+ = kop2tt+; 

*kepi++ = '\O'; 

if ( *ep2 == ' ' ) cp2++; 


TviInitialize(); 


/* Create blank map. All actual maps will be written as overlays to this. */ 
if ( !(win = InitTvWindow()) 

!(map = TvCreateMap( win, "Map Demo Application" )) 
!(nowin = TvCreateWindow( TvNoDevice, 0.0, 0.0, 1.0, 1.0 )) ) 


printf( "Cannot create map!\n" ); 
TvExit( @ ); 
} 


/* If no map file is entered on command line, this will open a simple prompt 
in TerraView window and let user enter name of a map. My application shouldn't 
display this, since I'm passing a map name from Access database */ 


char line [132]; 
while( (overlays == @) || line[@] ) 
{ 
TvPrompt( map, "Enter overlay name: ", line ); 
if ( line[@] && 
(overlay_user[overlays++) = TvReadOverlay( line )) == TvStatusError ) 


sprintf( txtbuf, "Cannot open overlay %s. Press ENTER to exit.", line ); 
TvPrompt( map, txtbuf, line ); 
TvExit( 9 ); 

} 


} 
} 
/* Read overlays from command-line */ 
while( (overlays < MAX_OVERLAYS) && (overlays < (arge-1)) ) 
if ( (overlay_user[overlays] = TvReadOverlay( argv[overlays+1] )) 
!= TvStatusError ) 
overlays+t+; 
else 


114 


ROOM 


sprintf( txtbuf, "Cannot open overlay %s. Press ENTER to exit.", 
argv[overlayst1] ); 
TvPrompt( map, txtbuf, txtbuf ); 
TvExit( @ ); 
} 
/* Now add the overlays to the blank map created above */ 
for( i= @; i < overlays; i++ ) 
TvAddOverlay( map, overlay_user[i] ); 
proj_.type = TvInqOverlayProjection( overlay_user[@], 16, proj_data ); 


/* Generate a grid, compass, and scale overlays */ 


grid = TvGenerateGrid( TvGridStyleLabeled ); 
compass = TvGenerateCompass( TvPositionBottomRight ); 
scale = TvGenerateScale( TvPositionBottomRight ); 


TvAddOverlay( map, compass ); 
TvAddOverlay( map, scale ); 


/* Display the map on the screen */ 
TvRefresh( map, TvAllOverlays ); 


/* This reads the file and puts the data onto the map overlay. */ 


companies = fopen("outfile.txt", "r"); 

for companies != EOF; 

{ 

stat = TvBeginFeature(ovl_sym, @, @, name, id); 


stat = TvInsertSymbol(ovl_sym, symbol, 1, point); 


stat = TvEndFeature(ovl_sym) ; 
TvRefresh(map) ; 
} 


/* This is a very simple main event loop that is used to process menu 
selections and mouse movements. */ 
while( GetMessage(&msg, (HWND)NULL, @, @) ) 
{ 


TranslateMessage( &msg ); 
DispatchMessage( &msg ); 
} 


return( msg.wParam ); 


/* InitTvApplication initializes window data and registers window class. */ 
BOOL InitTvApplication( hInstance ) 
HANDLE hInstance; 

{ 


"ViewMenu"; 
sizeof( LONG ); 
sizeof( LONG ); 


wc.lpszMenuName 
we.cbClsExtra 
we. cbWndExtra 

} 

/* InitTvWindow() creates MS Window and register it with TerraView */ 

TvWindowID InitTvWindow( VOID ) 


WNDCLASS' we; 

wc.lpszClassName = "TerraView"; 

we. hInstance = hInstance; 

we.lpfnWndProc = TV_process; 

we. style = CS_HREDRAW | CS_VREDRAW; 

we. hbrBackground = GetStockObject( BLACK_BRUSH ) ; 

we. .hCursor = LoadCursor( (HINSTANCE)NULL, IDC_ARROW ); 
we .hIcon = LoadIcon( hInstance, (LPSTR)"TvIcon" ); 


{ 

HWND hWnd; 

TvWindowID win; 

DOUBLE left, right, top, bottom; 


hWnd = CreateWindow( (LPSTR)"TerraView", (LPSTR)"TerraView for Windows", 
(DWORD)WS_OVERLAPPEDWINDOW, @, @, 
GetSystemMetrics( SM_CXSCREEN ), 
GetSystemMetrics( SM_CYSCREEN ), 
(HWND) NULL, (HMENU)NULL, 
(HANDLE)hInst, (LPSTR)NULL ); 

if (!hWnd) return( (TvWindowID)NULL ); 

win = TvUseWindow( TvDefaultDevice, (void *)&hWnd ); 

TvPDCtoNDC( TvDefaultDevice, GetSystemMetrics( SM_CXFRAME ), 
GetSystemMetrics( SM_CYFRAME ) + GetSystemMetrics( SM_CYCAPTION ) + 
GetSystemMetrics( SM_CYMENU ), &left, &top ); 

TvPDCtoNDC( TvDefaultDevice, GetSystemMetrics( SM_CXFRAME ), 

GetSystemMetrics( SM_CYFRAME ), &right, &bottom ); 

TvSetWindowBorderSize( win, left, right, top, bottom ); 

ShowWindow( hWnd, curshow ); 

curshow = SW _SHOWNORMAL; 

UpdateWindow( hWnd ); 

return( win ); 


/* TV_process(HWND, UINT, WPARAM, LONG) processes messages */ 
LONG FAR PASCAL TV_process( hWnd, message, wParam, lParam ) 
HWND hWnd; 
UINT message; 
WPARAM wParam; 
LONG lParam; 

{ 

FARPROC lpProcAbout; 

struct WinEvent event; 


event.hWnd = hWnd; 
switch( message ) 


case WM_CREATE: 
hAccTable = LoadAccelerators( hInst, "FunctionKeys" ); 
break; 
case WM_DESTROY: 
PostQuitMessage( @ ); 
break; 
case WM_COMMAND: 
switch( wParam ) 


{ 
case IDM_EXIT: 
case IDM_EDIT: 
case IDM_HELP: 
MessageBox( GetFocus(), "", 
"TerraView Mapping Application", MB_ICONASTERISK | MB_OK ); 
break; 
case IDM_ABOUT: 
lpProcAbout = MakeProcInstance( Tv_About, hInst ); 


Dr. Dobb’s Journal, August 1993 








DialogBox( hInst, "AboutBox", hWnd, lpProcAbout ); event .x LOWORD( 1Param ); 


FreeProcInstance( lpProcAbout ); event .y = HIWORD( 1Param ); 
break; TvQueueEvent( TvDefaultDevice, &event ); 


break; 


} 
case WM_PAINT: default: 
event.code = KBD_WINDOW_RESIZE; return( DefWindowProc( hWnd, message, wParam, lParam ) ); 
} 


event.x = event.y = 0; 
TvQueueEvent( TvDefaultDevice, &event ); return( (LONG)NULL ); 
TvResizeWindows( TvDefaultDevice ); } 
return( DefWindowProc( hWnd, message, wParam, lParam ) ); /* Tv_About processes messages for "About" dialog box */ 
case WM_SIZE: BOOL FAR PASCAL Tv_About( hDlg, message, wParam, lParam ) 
TvResizeWindows( TvDefaultDevice ); HWND hD1g; 
if (map) TvRefresh(TvDefaultDevice, TvAll0verlays) ; UINT message; 
#if @ WORD wParam; 
case WM_PAINTICON: LONG 1Param; 
#tendif { 
case WM_QUIT: switch (message) 
case WM_CLOSE: 
case WM_SYSCHAR: case WM_INITDIALOG: 
case WM_SYSDEADCHAR: return (TRUE) ; 
case WM_DEADCHAR: case WM_COMMAND: 
return( DefWindowProc( hWnd, message, wParam, lParam ) ); if ( (wParam == IDOK) 
case WM CHAR: (wParam == IDCANCEL) ) 
event.code = wParam; { 
event.x = event.y = @; EndDialog( hDlg, TRUE ); 
TvQueueEvent( TvDefaultDevice, &event ); return (TRUE); 
break; } 
case WM_LBUTTONDOWN: break; 
event.code = KBD_MOUSE1_DOWN; } 
event .x = LOWORD( 1Param ); return (FALSE) ; 
event .y = HIWORD( 1Param ); } 
TvQueueEvent( TvDefaultDevice, &event ); ich 
ab End Listing 
case WM_LBUTTONUP: 
event.code = KBD_MOUSE1_UP; 
event .x = LOWORD( lParam ); 
event.y = HIWORD( 1Param ); 
TvQueueEvent( TvDefaultDevice, &event ); 
break; 
case WM_MBUTTONDOWN: 
event.code = KBD_MOUSE2_DOWN; 
event .x = LOWORD( lParam ); 
event.y = HIWORD( 1Param ); 
TvQueueEvent( TvDefaultDevice, &event ); 
break; 
case WM_MBUTTONUP: 
event.code = KBD_MOUSE2_UP; 
event.x = LOWORD( 1Param ); 
event .y = HIWORD( lParam ); 
TvQueueEvent ( TvDefaultDevice, 
break; 
case WM_MOUSEMOVE: 
event.code = KBD_MOUSE_MOVED; 
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Apple Changes 
its Stripes 


would like to respectfully suggest 
that we have had enough research 
into the harmful effects of tobacco 
smoking. 

I make this suggestion for two reasons. 

First, we need the Federal revenue 
produced by cigarette taxes to reduce 
the deficit. There seems to be no prac- 
tical limit on cigarette taxes. Smokers 
will basically pay whatever they have 
to pay for cigarettes. 

Don't believe it? 

Consider: Yes, we’ve all heard ex- 
smokers claim that they just couldn’t af- 
ford it any more. But have you ever met 
an ex-smoker for whom you truly be- 
lieved that price was the decisive factor 
in kicking the habit? There are so many 
other reasons to quit smoking: social os- 
tracism, the need to climb stairs, the 
health of family members, incon- 
venience, the spot on the X-ray, dead 
relatives. According to my research, there 
has never been a case of a smoker giv- 
ing it up solely because of the cost. But 
what about cost as a contributing factor? 

Consider: Canada has raised taxes on 
cigarettes with absolutely no effect on 
cigarette sales. Granted, it did create a 
thriving black market in cigarettes im- 
ported from the Lower 48. But adjust- 
ments to U.S. and Mexican tax codes 


Michael Swaine 


and a little tweaking of the North Amer- 
ican Free Trade Agreement should 
take care of Canada’s black market 
problem and head off any such prob- 
lem for the U.S. 

Consider: Nicotine is an addictive 
drug, and the street price of other ad- 
dictive drugs suggests that addicts will 
always find the money to support their 
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habit. My research suggests that a tax 
of $100 per pack would have zero ef- 
fect on cigarette consumption, and 
would bring in an extra $0.3 trillion per 
year in Federal revenues. (Or, to put it 
in more meaningful terms, it would pay 
for 20 haircuts per second for the Pres- 
ident for the duration of his term.) 

What does seem to have some slight 
effect on consumption is all these dis- 
couraging studies. Eliminating them and 
instituting a $100/pack tax would put 
quite a dent in the deficit. That’s my first 
reason. Lest it appear that I am placing 
economic issues above public-health is- 
sues, my second reason will make clear 
that I am very concerned about public 
health. 

Reason two: We should take the mon- 
ey currently being spent on research 
into the harmful effects of tobacco 
smoking on physical health and spend 
it on research into the harmful effects 
of tobacco growing on mental health. 
This area of research has been shame- 
fully neglected, and it’s obviously a se- 
rious problem. 

What other explanation could there 
be for Senator Jesse Helms? 

All the examples of Helmsmanship 
look pretty much the same. Here’s the 
latest, as of press time. 


1. Helms effectively admits to a journal- 
ist that his opposition to a HUD under- 
secretary nominee is based on his own 
intolerance. (Actually, Helms invited the 
journalist to characterize his attitude as 
bigotry, but I will not take up the invi- 
tation. While I find Helms and his views 
as repugnant as rat vomit, I see no need 
to be insulting.) 

2. Days later, Helms accuses this nomi- 
nee of intolerance. His reason, translat- 
ed into English, is that the nominee is 


an unabashed civil rights activist. In 
Helms logic, being an activist for civil 
rights ipso facto makes one intolerant. 
Intolerant of intolerance, you see. 


Sounds like the same logic that says 
that all animals are equal but some are 
more equal than others, as articulated 
by a pig in George Orwell’s Animal 
Farm. There are Orwellian pigs in ev- 
ery state in the union, but only North 
Carolina pigs are so well represented in 
the Senate of the United States. 


MacOpen 

The Senator from North Carolina prob- 
ably wouldn’t care for what’s going on 
in operating systems today. The key 
word is “open”. PowerOpen, Open Sys- 
tems Foundation, everything is open- 
ness. Especially at Apple, where, it 
would seem, a long-standing tradition 
of proprietariness has been trash-canned. 

The most dramatic evidence in how 
far things have gone was a statement 
made by Apple’s Senior Vice-President 
and General Manager of the Macintosh 
Software Architecture Division and the 
Advanced Technology Group, David 
Nagel, at Apple’s Worldwide Develop- 
er’s Conference this May. 

Nagel said, “From now on, no major 
technology will be introduced from Ap- 
ple that is not cross-platform. The goal 
is near-simultaneous release.” 

Now, there are at least three ways 
one could read this statement. 

You could take it to mean that Apple 
will henceforth follow a model of de- 
veloping system tools and making them 
simultaneously available on the Mac and 
on Windows. This seems to be a safe 
reading, supported by a recent an- 
nouncement from Kaleida, the Apple- 
IBM joint venture in multimedia tech- 
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Windows featuring a graphic form editor 
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Spell Time 

Spell Time consists of a dictionary 
(over 100K words) and the routines to access 
the dictionary. It also includes an application 
specific dictionary, and a user dictionary. The 
routine will suggest alternatives for a 
misspelled word. Highly optimized: 400 to 
500 words/sec on a 33 Mhz 386 computer. 
An interface with TE included. Includes the 


complete ‘C’ source code. Specify 20S, 
Windows or OS2-PM. ($369) 
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a window, printer or a bitmap. Features 3d 
rotation and dialog boxes to edit chart 
parameters. Includes the ‘C’ source code. 
($379). 
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nology. Kaleida decided to delay the re- 
lease of its ScriptX multimedia scripting 
technology until next year so that it 
could be released simultaneously on 
Mac and Windows. 

You could also take Nagel’s statement 
to mean that Apple is decoupling its op- 
erating system and user-interface soft- 
ware from its hardware. I’d say that’s a 
safe reading, too. In a dramatic break 
with the past, Apple is licensing its op- 


Bedrock isn’t Apple’s 
(or Symantec’s) last 
word on 
multiplatform 
development 


erating system technology to others, and 
porting or supporting the porting of the 
Mac OS and/or GUI to DOS, Windows, 
and various UNIX platforms. 

You could also read Nagel’s statement 
to mean that Apple is getting out of the 
hardware business. Well, couldn’t you? 
“From now on...no major technolo- 
gy...that is not cross-platform.” Ever 
heard of a cross-platform computer? 
Taken literally, Nagel’s statement means 
either that Apple is out of the hardware 
business as of today, or that any new 
machines it introduces in the future will 
not be major technology. 

But this is nonsense. Apple will be 
introducing PowerPC Macs within the 
next year, based not only on a new chip 
family (the PowerPC) but on a differ- 
ent chip technology (RISC vs. CISC). 
That’s surely new hardware technolo- 
gy. Nagel didn’t mean that Apple was 
through pushing iron, and he didn’t 
mean that its hardware releases 
wouldn't be “major technology.” Any- 
way, Nagel is a system-software guy; 
he was clearly talking about his domain, 
not all of Apple. 

But the assertion wasn’t qualified in 
any way. So isn’t it just a little sugges- 
tive that it didn’t raise any eyebrows 
within Apple? This major announcement 
surely passed under many eyes before 
being delivered at the conference. Yet 
nobody thought to mention that Apple 
was still, of course, going to produce 
machines, for a while at least. Which 
shows, perhaps, where their minds are. 
Apple really is starting to think of itself 
as something other than a computer 
manufacturer. It’s comforting, I guess, 
to know that some things don’t change, 
and that the Apple corporate mind re- 


mains farther out on the curve than the 
Apple market reality. 

In any case, the uncoupling of the 
Macintosh operating system and user 
interface from the Mac hardware is rad- 
ical. What does it mean? 


MacDOS 

First, there’s the Apple-Novell plan to 
put the Mac operating system and UI 
on Intel-based machines. This sounds 
like it would have been a stunning coup 
for Apple two years ago, but today it 
seems a little late to challenge Windows 
on its home court. What’s the deal? 

Well, it’s supposedly a plan to offer 
an alternative to DOS users who are 
ready to bite the bullet and move up to 
a graphical UI, or Windows users con- 
sidering the move to NT. It’s due out in 
the first half of 94, and here’s what it 
consists of: 

The Mac Finder and Toolbox, dis- 
playing a System 7 interface, running 
on top of Novell’s DR DOS, with the 
Mac file system mapped onto the DOS 
file system, the whole thing capable of 
running on 386, 486, and Pentium box- 
es, and supporting multitasking of Mac 
and DOS applications. Not Windows 
apps, at least not yet. 

And that’s not just existing DOS ap- 
plications, but ported Mac applications. 
So what the deal is for developers is 
this: You port your Macintosh apps to 
this Intel platform and you'll have an 
expanded market for them. Since the 
Toolbox and some other Mac compo- 
nents are already ported, the port won’t 
be too daunting a job, and Apple and 
Novell will explain to you what steps 
you need to take to do the port. 

I’m sorry, but I just don’t see this as 
a terribly compelling deal for applica- 
tion vendors. 

If they are considering porting their 
apps to Windows, they now get to com- 
pare the currently nonexistent market 
for applications on this MacDOS plat- 
form with the existing huge market for 
Windows apps, weighed against the rel- 
ative porting costs. Unless the port is 
very easy or Apple and Novell push this 
platform very strenuously, it’s hard to 
see the comparison working out in Ap- 
ple’s and Novell’s favor. Vendors will 
port to Windows first. 

And if the vendors have already port- 
ed to Windows, then any success that 
this platform has in cutting into the Win- 
dows market will arguably be at the cost 
of the application vendors’ sales on Win- 
dows. If they do find it necessary to port 
to what I’m calling “MacDOS,” it will be 
grudgingly, to win back market share 
that they were already counting as 
theirs. Not an inviting scenario. 

There are scenarios for success with 
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this thing. If porting is extremely easy 
and if enough vendors port their apps 
to it soon enough that Apple is able to 
say convincingly, “You can now have 
the virtues of the splendiferous Macin- 
tosh interface rather than that inferior 
copy of haphazard design and incon- 
sistent execution, and run true Macin- 
tosh applications on those inelegant dirt- 
cheap clone boxes from the Orient that 
you're so fond of,” then maybe there’s 
a decent-sized market. And that market 
would be even more decent-sized if Ap- 
ple and/or Novell could figure out how 
to give an affirmative answer to what 
you just know will be the first question 
that anybody who owns an Intel ma- 
chine will ask about this platform; to 
wit: “Will it run [fill in your favorite Win- 
dows appl?” 
But how likely is any of that? 


Macnix 
Then there are the plans, very plural, to 
port the Mac system and/or interface to 
UNIX. 

First of all, there’s Apple Services for 
Open Systems. This approach lets Mac 
applications run without modification 
on UNIX platforms in an X window. 
The pitch for the user is, you keep the 
benefits of the UNIX operating system, 
and the existing pool of Mac applica- 
tions is open to you as well. 

Second, there’s the plan to port the 
Toolbox and APIs to various UNIX 
platforms. This would mean, if I’ve got 
it right, that in addition to porting ex- 
isting apps to UNIX, you could write 
something that is obviously a Mac app, 
but that’s written specifically for the 
UNIX platform you’re working on. A 
weird trip. The pitch to the developer 
is, you want to work in UNIX but you 
like QuickDraw or AppleShare or Ap- 
ple Open Collaborative Environment? 
We'll sell you the technology you want, 
ported to your particular hardware 
platform. 

Then there are the Quorum ap- 
proaches. Quorum Software Systems 
(Menlo Park, California) has two prod- 
ucts that let Mac software run on UNIX 
machines. One is a $6,000 porting tool 
named Latitude; it lets you port Mac 
apps to UNIX without touching source 
code and reportedly delivers good per- 
formance. The other is a $695 end-user 
product that lets several specifi¢ popu- 
lar Mac applications run on UNIX sys- 
tems, using the host system’s user in- 
terface; Motif, for example. 

If you’re one of those who thinks that 
the worst thing about the Mac is the op- 
erating system, then some of these UNIX 
moves may sound a lot more interest- 
ing than the Apple-Novell plan of graft- 
ing the Mac UI onto DOS. 
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MacRISC 

One almost gets the feeling that these 
ports of major pieces of the Macintosh 
to existing platforms are just practice for 
the main event, which is the port to the 
PowerPC. In fact, Apple is telling ven- 
dors that making their apps portable to 
the Intel platform will help in porting 
them to the PowerPC. This IBM/Ap- 
ple/Motorola-engendered RISC chip is 
Apple’s future (and not so distant fu- 
ture, at that) hardware platform. At the 





developer’s conference, Apple execu- 
tives were gloating that PowerPC was 
delivering better performance than ex- 
pected, and drawing a lot of compar- 
isons with the bigger, doubtless more 
expensive, more heat-producing Pen- 
tium. More than double the Specmarks 
per watt was one comparison. Apple 
expects to sell a million PowerPC Macs 
in 94; this is the first mass-market de- 
livery of RISC technology, and Apple 
really plans to mass-market it. 
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PROGRAMMING PARADIGMS 


Unported Mac software can run on 
Apple’s PowerPC machines via emula- 
tion, an approach that has rarely in the 
past produced acceptable performance 
on any platform. But at the develop- 
er’s conference, Apple demonstrated 
Mac software running with impressive 
speed in 680x0 emulation mode on a 
PowerPC machine. Because the Tool- 
box has been ported to the PowerPC, 
and because of the advantages of the 
PowerPC over existing Motorola CPUs, 
the emulated software can actually run 
as fast as or faster than it would run 
on a fast 68040 Mac. If ported rather 
than emulated, it could run several 
times faster. 

There are currently two ways to port 
Mac apps to the PowerPC. EchoLogic’s 
FlashPort is a direct binary-to-binary 
translator from 680x0 code to PowerPC 
code. That doesn’t sound ideal, but Ap- 
ple is using it to port elements of the 
Mac OS to PowerPC, with apparently 
excellent results. And Apple and Syman- 
tec should have a C compiler for Pow- 
erPC out about the time you read this. 
Pascal programmers will have to use 
FlashPort or wait longer, I guess. And 
then Bedrock is the next step. It'll be 
possible to get your hands on Bedrock 


late this year; the real final release is 
scheduled for mid-94. 

Bedrock is the replacement for Ap- 
ple’s unloved MPW, which is going away 
unmourned. Bedrock is Symantec’s and 
Apple’s C++ application framework for 
writing portable applications. The idea 
is that you'll have a single source for 
your entire program, including all re- 
sources, and it'll be written with Bedrock, 
and that source will compile to a Mac- 
intosh application for a 680x0 Mac, a 
Windows application for an Intel ma- 
chine, or a PowerPC Mac application for 
a PowerPC Mac. It’s important to note 
that: 1. Apple intends this to be used not 
only by commercial developers but also 
by corporate developers; and 2. Mac and 
PowerPC Mac and Windows platforms 
are just the first platforms that Bedrock 
is intended to support. 

Bedrock isn’t Apple’s (or Symantec’s) 
last word on multiplatform develop- 
ment. Bedrock has been designed to let 
you use the parts of it you like and by- 
pass it where there is some advantage 
in doing so. Apple and Symantec are 
also working on various native Power- 
PC development tools, including, I sus- 
pect, MacApp. Some of these will be 
out this year. 
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MacNeXT? 
Why all this porting madness all of a 
sudden? Is it just a prelude to Power- 
PC, or is there another reason? Maybe, 
mmm, oh I don’t know, could it be— 
SATAN? !? 

Yep, Apple’s responding to the latest 
campaign by the Evil Empire to take 
over the world. 

And one of the most dramatically 
open technologies is a direct response 
to Microsoft’s OLE. (Well, some might 
call it a response to NeXTstep.) 

I’m talking about Amber. 

Amber is a technology for the devel- 
opment of a new form of software prod- 
uct for a new model of computer use. 
The model is document-centered com- 
puting, and the form of software is the 
component tool. 

Document-centered computing means 
that, rather than working with applica- 
tion programs that support specific kinds 
of documents, the user works with a 
document and calls up particular tools 
or suites of tools to operate on differ- 
ent kinds of data in that document. The 
user never leaves the document to get 
something done. Any document can 
support any kind of data. All tools are 
editing tools of some sort, and all edit- 
ing tools are usable in all documents. 

This model implies a different form 
of software product, the small, focused 
tool or suite of tools, as opposed to 
the monster app. Since the document- 
centered model takes away from the 
third-party developer most of the in- 
terface and all of the integration of ca- 
pabilities, it pretty much destroys the 
whole concept of the application as 
we know it today. Writing document- 
centered software tools won’t be hard, 
but it will take some guidance and spe- 
cialized tools from Apple, and that’s 
what Amber is about. 

Amber is like Microsoft’s OLE and will 
compete with it, but there are a couple 
of interesting twists. First, Amber will 
fully support OLE. Second, Amber 
source code will be public domain. Ap- 
ple is going to release all source for any 
use without restriction. Apple is setting 
up a nonprofit Amber association to pro- 
mote Amber, discuss standards, port the 
code, and the like. Amber is intended 
to be available for Windows and UNIX 
as well as Mac. The Mac source code 
will be seeded to developers by the end 
of this year. 

The final twist is that Amber itself, Ap- 
ple admits, is just a stepping stone to 
programming for Taligent, Apple’s next 
operating system. 

Next month: Satan’s side of the story. 
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C PROGRAMMING 


Embedding a Keyboard 
and Singin’ the Blues 


t's August, the annual C issue and 

my anniversary. I began writing this 

column five years ago this month. 

I'd regale you with the story of my 
rise to eminence, but at a recent con- 
ference a young reader took me to task 
for my occasional trips down memory 
lane. “Who cares about the good old 
days?” he wanted to know. I realized 
then that someone too young to have 
a past might very well have no appre- 
ciation or reverence for tradition and 
nostalgia. 

So, instead of an inconsequential rem- 
iniscence, I’ll tell a simple story that 
leads into this month’s project, in which 
I'll build a simple hardware device to 
emulate the PC keyboard, then devel- 
op the necessary driver software in C. 
First the story. 

My brother, Fred, is a consulting en- 
gineer who, among other things, de- 
signs hardware. One of his clients is an 
entrepreneur named Wolfie, and some 
of Wolfie’s enterprises involve the appli- 
cation of color terminals in embedded 
systems. The color screens that an- 
nounce flight arrivals and departures at 
some airports are Wolfie’s. Another of 
Wolfie’s systems is a script-driven auto- 
mated driver’s-license test that enables 
applicants to answer multiple-choice 
questions displayed on the color 


Al Stevens 


screens. At the time of this story, the 
system used a popular color terminal 
and a five-key keyboard with A, B, C, 
D, and Enter keys. Wolfie’s prototype 
employed the terminal’s standard 
QWERTY keyboard, but the final prod- 
uct had to have only the five keys. 
Building the custom keyboard was 
Fred’s job. Fred called one day and 
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asked me to help assemble some key- 
boards. They were due the next day, 
he was late getting started, and Wolfie 
was fretting. We stayed up all night 
building them. Each keyboard had five 
embossed keys, cable, and keyboard- 
controller electronics built into a nice 
professional-looking box. It was mind- 
less work and we had a great time sol- 
dering, assembling, drinking coffee, and 
talking until dawn. Wolfie shall be, he 
said, eternally grateful for my assistance. 
That’s how Wolfie talks. End of story; 
now on to the project. 

Those custom keyboards came to 
mind recently when I began to prepare 
a lecture for the Borland International 
Conference, held in San Diego in May. 
Usually I use overhead transparencies, 
but this particular lecture called for a 
number of slides interspersed with on- 
line demonstrations of compiles and ex- 
ecutions of the demonstration program. 
The conference speaker liaison said that 
it might not be easy to switch projec- 
tion systems during the speech. So I de- 
cided to prepare everything on a lap- 
top, plug into their VGA projector, and 
proceed with one projection system. 

When speaking to programmers, I like 
to walk around the room with the brief- 
ing slides in the background and my at- 
tention on the attendees. The confer- 
ence rooms usually come with a wireless 
microphone, which lets me be Phil Don- 
ahue, running all over the room, even 
going down into the audience. That has 
always worked, because I could stroll 
back to the podium to change slides. I 
figured on using the same technique 
with the automated slide show but found 
that in rehearsal I’d often hit the wrong 
laptop key. They don’t lay those things 
out very well, and during a speech my 
attention is anywhere but on that 
cramped keyboard. That’s when I re- 





membered Wolfie’s five-key keyboard. 
With one of those to carry around, I 
could control the slides from anywhere 
in the room and have fewer wrong keys 
to press. A keyboard like that would 
work in many embedded applications 
as well—arcade games, shopping-mall 
directories, electronic catalogs, comput- 
er-assisted instruction, and the like—so 
it seemed to be a project worth investi- 
gating. 


The Hardware 

Building a PC keyboard is easy enough 
if you know how the keys interact with 
the electronics and you have the nec- 
essary parts and cabling. I didn’t want 
to do anything that fancy in hardware, 
though, because I prefer using software 
to solve problems. Besides, I wanted to 
build the keyboard with inexpensive 
parts off the Radio Shack rack. 

Not using a keyboard-controller chip 
means I can’t use the keyboard port itself. 
The mouse has the serial port tied up, 
so that leaves the printer port. The next 
problem is figuring out how to use it. 

A PC’s printer port has 3 input/ 
output addresses and about 13 lines that 
could be used for data. Eight lines car- 
ry the eight bits of printer data, but those 
are write-only signals on some ma- 
chines. The other lines are control sig- 
nals. Whether those lines are readable 
or not, and how you read them differs 
from machine to machine. The Cen- 
tronics protocol and the standard PC 
printer specification leave a lot of room 
for unique implementations. Devices ex- 
ist that use the printer port for bidirec- 
tional data exchange. I have a Xircom 
network adaptor that uses the printer 
port as an Ethernet port. The infamous 
dongle sends an encoded value from 
the printer port to serialize protected 
software. Many laptops use the printer 
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port for an external disk-drive port. So, 
it must be possible to connect some- 
thing other than a printer to that port 
and read data from it. 

The printer connector has no voltage- 
supply pin, which means that there’s no 
power supply for any digital circuitry in 
a device. The Xircom adaptor uses an 
external AC adaptor power supply of 
its own. I didn’t want to do that. Instead, 
I decided to try to read meaningful sig- 
nals by grounding the data and control 
pins at the printer connector, which is 
a mechanical solution that involves no 
electronics. You can do this, but differ- 
ences in printer-port implementations 
means there’s no common denomina- 
tor. Not even one pin. So, before you 
begin, you must determine how your 
particular printer port works. 

Listing One, page 148, is port.c. It 
reads and displays the hexadecimal val- 
ues of the two sets of three printer I/O 
ports. To use the program, you need a 
25-pin cable with a male end to plug 
into the computer’s printer port and a 
female end for your test. You also need 
two metal paper clips and a test lead 


(a) 


@378 9379 037a O3bc O3bd O3be 
Q00b OO7F OOCH OGL BOLL OOF 


(b) 


5 

510@ 379 40 00 20 
4900 379 80 80 20 
4800 379 20 08 OO 
5000 379 10 BB BO 
3b@0 37a G1 O1 BO 





Figure 1: (a) port.c output; (b) table 
that describes the keys to simulate. 
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with alligator clamps. Plug the cable’s 
male end into the printer port. Bend out 
one end of each paper clip, and insert 
one of them into the hole for pin 25 of 
the female end of the cable. Connect 
one end of the test lead to this paper 
clip and the other end to the other, 
loose, paper clip. 

Compile and run port.c. When you 
run it, type a 0 as the only command- 
line parameter. The 0 is the value that 
the program will write to the printer 
ports before reading them. Many print- 
er cards leave the signals “floating,” 
which means they’re neither +5 volts 
nor grounded, but depend on the print- 
er to pull them up and ground them. 
Without a +5 line to pull these floating 
lines up, their values at any particular 
time are unreliable. You can, however, 
condition the initial value by writing all 
Os or all 1s to the port before you read 
it. The idea is to pull the port’s lines up 
to +5 volts and then ground pins one 
at a time to see if you can read the ef- 
fect by reading the ports. Whether you 
write Os or 1s depends on which value 
sets the port lines “high.” You have to 
experiment to find out what works with 
your system. There are many uncon- 
ventional implementations, particularly 
in laptops, that manage to look con- 
ventional at the BIOS level and also 
work at higher levels such as DOS and 
Windows. 

The port.c program continuously dis- 
plays the output in Figure 1(a). The dis- 
play shows the two sets of three ports 
for LPT1 and LPT2 with their port ad- 
dresses across the top and the data val- 
ues read from each port under its ad- 
dress. In Figure 1(a), the first three 
addresses, which address LPT1, have 
values; the second three, which address 
LPT2, are all Oxff, which means that the 
second printer port probably isn’t in- 
stalled. The association between port 
addresses and the logical LPT1 and 
LPT2 devices is made by DOS at start- 
up time. If DOS finds only one set of 
active ports, it sets those ports up as 
LPT1, regardless of which port ad- 
dresses it finds. 

While port.c is running, insert the free 
paper clip into the hole for pin 1 in the 
cable’s female connector, then the hole 
for pin 2, and so on, all the time 
watching the program’s output. When 
a grounded pin produces a readable 
change in one of the ports, the hexa- 
decimal data value under the port’s ad- 
dress changes. Only one bit position of 
one port changes. If you don’t get 
enough satisfactory results, rerun the 
program with 255 as a command-line 
parameter to write all 1s to the ports 
before you read them. Some signals are 
asserted high, others low. Record the 


results of the program for all the pins 
that change the display when you short 
them. The signals that change can be 
used for keystroke values on your re- 
mote keyboard. The output will tell you 
which pins to connect to the buttons 
on the keyboard and how to translate 
the port values into simulated key- 
strokes. Press Ctrl-Break to exit from 
the program. 

Next you must build the keyboard. A 
trip to Radio Shack serves up a hobby 
project box (#270-230), some momen- 
tary, normally open SPST push buttons 
(#275-1556), and a 100-foot spool of six- 
conductor telephone wire (#278-874) 
with enough conductors for five buttons. 
The only part I couldn’t get at Radio 
Shack was the 25-pin male EIA con- 
nector and hood, which I found at a lo- 
cal electronics supply house. Drill holes 
in the hobby box for the buttons and 
cable to go in. Mount the buttons in the 
hobby box, run the cable into the box, 
tie a knot in the cable on the inside of 
the box to keep it from pulling out, and 
connect one end of the the black wire 
from the telephone cable to one side of 
all of the buttons. This wire will be the 
ground wire. Connect the other end of 
the black wire to pin 25 of the EIA con- 
nector. Connect the other five wires to 
the other sides of the push buttons, one 
wire per connection. Connect the other 
ends of the five wires to other pins on 
the EIA connector choosing those pins 
that provided readable signals when you 
grounded them in your test. Make a di- 
agram of which buttons are connected 
to which pins. 

After the keyboard is built, you must 
decide which buttons correspond to 
which simulated keystrokes. Plan this 
part carefully. You'll want to arrange the 
buttons in intuitive positions with re- 
spect to one another, depending on 
how you use them. I use the five but- 
tons to simulate Fl, PgUp, PgDn, and 
the up and down arrow keys. 


The Software 

So much for the hardware. Now you 
must determine which PC keys to sim- 
ulate. That depends on the application 
that uses the keyboard. To get the 
keyboard scan codes for the selected 
keys, compile and run kb.c (Listing 
Two, page 148) which reads the key- 
board and displays the scan codes of 
the keys you type. Type the keys you 
want to simulate and write down their 
scan codes. Type Esc to exit from the 
program. 

Next build an ASCII file with a table 
that describes the keys to simulate; I use 
the table in Figure 1(b). The first line 
specifies how many keys to simulate, 
five in this example. Each of the remain- 
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ing lines defines a key. The first four- 
digit value is the hexadecimal keyboard 
scan code, as reported by kb.c. The 
second value on the line is the hexa- 
decimal printer port that will deliver a 
changed value when the corresponding 
button grounds a pin. The third value is 
a hexadecimal value that identifies the 
bit position that will change. The pro- 
gram that uses this table will AND this 
value with the value read from the print- 
er port. The fourth value is either the 
same as the third or 0, depending on 
whether the bit changes from 0 to 1 or 
1 to 0, respectively, when you push the 
button. The last value is either 00 or ff, 
to specify the value that conditions the 
port before the program reads it. 
Listing Three, page 148 (pb.c), con- 
verts the push buttons to keystrokes. It 
is a TSR, and it intercepts the BIOS 0x16 
keyboard interrupt vector and the 
system-timer interrupt vector. To run the 
program, enter its name and specify the 
table file as standard input like this: 


C:>pb< keytable 


When the program loads, it reads the 
table. into memory. Then it hooks and 
chains the two interrupt vectors and be- 
comes resident. 

Application programs call interrupt 
0x16 to read the keyboard. kb.c in- 
tercepts that interrupt and uses the but- 
ton-definition table to test the printer 
ports to see if one of the programmed 
buttons has been pressed. If so, the 
programmed scan code is returned. 
Otherwise, the program passes con- 
trol to the chained 0x16 interrupt han- 
dler so that the real keyboard works 
as usual. 

The program uses the timer interrupt 
to regulate the typematic repeat rate of 
the keyboard. As with the standard key- 
board, an initial delay is followed by a 
shorter one for subsequent repeats for 
the same, prolonged key press. 

The keyboard and pb.c program are 
not perfect. For example, the program 
does not work with Windows. You’d 
need to write a specific Windows- 
keyboard device driver program for that. 
Your meanderings around the lecture 
hall are limited to the length of the ca- 
ble, too, which tends to get tangled if 
you go too far or if you stuff the box 
into your briefcase. Wireless devices that 
use radio frequencies or infrared tech- 
nology (ike a TV’s remote control) can 
emulate more keys and the mouse, but 
they’re more expensive than our home- 
built device. Even with its shortcomings, 
though, the keyboard simulator solves 
a problem for me and is an inexpen- 
sive way to add custom keyboards to 
other embedded systems. 
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The Tech-support Blues 

Some of you are responsible for tech- 
nical support in your companies. That’s 
where programmers do penance for 
having written programs that other peo- 
ple want to use. It’s called, “paying your 
dues with the tech-support blues.” Be- 
sides providing tech support, most of 
you, as users of compilers and such, 
will at one time or another be on the 
receiving end of a tech-support service, 
and that experience can give you an- 
other version of the blues. 

I’ve had those tech-support blues 
three times in the recent past, as a con- 
sumer rather than a supporter, and | 
have some observations that might help 


you the next time you consider buying 
a product or the next time your own 
tech-support phone rings. 

There are several ways to provide 
tech support. You can provide a phone 
number, preferably an 800 number so 
your users don’t have to pay to be on 
hold. You can use a fax. You can put a 
sysop on a CompuServe forum, a meth- 
od that I like because other users can 
chime in to help, and the phone is nev- 
er busy. But regardless of which method 
you use, if you offer tech support, you 
ought to be prepared to deliver on your 
promise. Here’s how well all three meth- 
ods worked for me recently. 

I bought a new computer from Gate- 





Mouse, Menu Bar (and More) in 


Lugaru Software proudly presents 
Epsilon version 6.5. This latest release 
of our award-winning programmer s 
editor is now available for DOS and 
OS/2, and it’s got mouse support, a 
menu system, and many other great 
features. We're constantly improving 
Epsilon, making it more useful to 
you, and this is the latest result. 


Mouse Support 

We designed the mouse to be 
as non-intrusive as Possible, env arh 
so that when you're not 
using the mouse, you 

- won't notice it’s there. 
We don’t reserve valuable 
screen space for scroll bars— 
Epsilon’s scroll bars pop up when you 
move the mouse over them. And 


Epsilon automatically hides the mouse ™y\) 


cursor when you're typing, so it 
doesn’t get in your way. 

On EGA and VGA displays 
under DOS, Epsilon uses special 
techniques to display a graphical arrow 
cursor in “text mode.” With no 
jumping block cursor, the mouse is 
easier to position, but Epsilon avoids 
the overhead of graphics mode, which 
can slow down screen updates. 

You can now run commands from a 
pull-down menu bar. Select 
commands with the mouse, or access 
the menu from the keyboard. Like 
Epsilon’s scroll bars, the menu doesn’t 
take up any screen space when you re 
not using it—Epsilon pops up the 
menu bar when you move the mouse 
past the top of the screen. Naturally, 
you can make the menu bar or the 
scroll bars permanent if you prefer, or 
customize the mouse and menu system 
in many other ways. It’s easy to change 
the menu—just edit a special file. 
Epsilon can automatically fill in the 
keyboard equivalents for the - 
commands you add. 


Improved C mode 

Epsilon can scan your C source files 
for function definitions, and jump 
directly to a function’s definition when 
you type its name. Or while editing a 
function call, you can press a key and 
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Epsilon 6.5! 


jump instantly to the function’s defini- 


tion. Now, in Epsilon 6.5, you can do 


the same thing with C variables, typedefs, 
macros, and structure and union tags. 
You can choose to record only 
WS definitions, as in previous 
versions, or declarations as 

_ well. This is especially 
handy for library 
header files, where 
you might have only 
the declarations, not the 
definitions, of functions and 


———svariables. 


Epsilon provides automatic 
| indenting and reindenting of 
your C code. It does 
sophisticated reverse-parsing of 
your program to 
=e determine the correct 
indentation, unlike some other 
editors that only look at the 
previous line, and often 
misindent. Now Epsilon is 
smarter about indenting 
some relatively 
uncommon C constructs, 
and it offers more variables 
for customizing it to your 
indenting style. 

You can now double-click \. 
with the mouse on a subroutine 
or variable name, and Epsilon will 
jump to its definition. This is 
especially convenient when 
browsing source files—you can 
navigate using only the mouse. 


Customize the screen 

New variables let you customize the 
screen's appearance, moving the echo 
area or mode lines, or adding borders 
around windows. 


Epsilon can display more background 


colors (including brighter whites) on 


EGA and VGA systems. Now a total of 
256 foreground/background 
combinations are available, twice as 
many as before. 


Much more 
The new version has lots of other 












improvements as well, too many to 
mention here. And of course, Epsilon 
6.5 has all the features of previous 
Epsilon versions: 


¢ Multitasks compilers, even in DOS. 

* Scans compiler errors (customizable). 

* Full undo/redo retained after file saves. 

¢ Unlimited number of files or windows. 

* No built-in limits on line length or file 
size. 


© Ultra-fast multi-file search. 


* File comparison commands compare 
by lines or by characters. 

* Switch among 80x25, 80x50, 4 other 
VGA video modes, with a keypress. 


_ © Fully utilizes EMS & XMS memory & 


upper memory blocks. 
* EMACS-style command set. 
* Interactively customizable keyboard. 
* Record keystroke sequences. 
* Context sensitive help autoconfigures. 
¢ Fast C-like extension language. 
* Source code to all commands. 
¢ Regular expression (wildcard) 
search & tagged replace. 
* Permanent and temporary bookmarks. 
eAnd much more! 


Epsilon 6.5 is 
available now for 
$250. Updates are 
only $45 from version 
6.0, or $60 from any 
previous version. 

Now is the perfect time 
to try Epsilon for yourself. 
We offer a 60-day money- 
back guarantee. If you're 


not totally thrilled with Epsilon, just 
send it back and receive a full refund. 
Why not call us now? 
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VICE/CIN 


© 1993 AT&T 


Edit, interpret, test and debug C-language programs. Catch 
errors in syntax, variable typing, logic flow and pointer 
consistency. VICE/CIN (Visual C Environment Interpreter) 
lets you do it all, all within one seamless system. 

Because VICE/CIN eliminates switching between many dis- 
similar tools, it also saves you time. Plus the interactive mode 
shortens the write, test, debug cycle with instant feedback of 
program errors and execution results. VICE/CIN makes 
experimenting quick and easy, too. And its many options 
provide endless customization possibilities. 

To find out how VICE/CIN can be a quick fix within your 


operations, call 1 800 462-8146 or fax us at 1 908 580-6355. 
We'll also send you a free copy of our AT&T Software 
Solutions Catalog. 


SOFTWARE SOLUTIONS GROUP 
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OPTLINK tiner HEADACHES 


Offers Borland C++-based developers 33% faster linking, 
33% smaller programs and 75% smaller debug-programs. 
NO LIMITS on Turbo Debugger info. 

Ask us about Visual C++ features too! 
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C PROGRAMMING 


way 2000. They’re one of the high- 
visibility clone makers with multipage, 
full-color, centerfold ads in magazines. 
They have an 800 number for taking or- 
ders. You never have any trouble get- 
ting through to that number. There’s al- 
ways an eager sales person ready to 
take your order. My new computer is a 
belch-fire, neck-snapper 66-MHz 486, a 
programmer’s dream because it bangs 
out long makefiles quicker than you can 
watch for warning messages. Gateway 
has a 30-day return policy. If you don’t 
like it, send it back. I liked it, but it had 
a problem: It wouldn't run Brief 3.1. Ev- 
ery time I saved a file and exited, the 
computer displayed a divide-by-zero er- 
ror message and locked up. Surely, says 
I, they’ve heard about this one. They 
have an 800 number for tech support. 
Trouble is, it’s always busy. That’s odd, 
the sales line is always available. It 
seems to me that a company should 
have more sales than problems to stay 
in business. If a line’s going to be busy, 
it ought to be the one getting the most 
calls. But for two weeks I dialed tech 
support, and for two weeks I got a busy 
signal. Finally I called the company’s re- 
ception line and they promised me a 
“guaranteed call-back.” Two more 
weeks went by. No call-back. I kept try- 
ing the tech-support line, which was al- 
ways busy, and my 30 days were run- 
ning out. So I called reception again and 
talked to Heather. Right off, she want- 
ed to give me a guaranteed call-back. 
No soap, I said, I’ve tried that and it 
doesn’t work. Let me talk to someone 
right now or I’m sending this turkey 
back. Enter the Catch-22. You can’t get 
a return authorization, said Heather, un- 
til you’ve discussed your problem with 
tech support, and their line is busy. Let 
me talk to your supervisor. He’s busy, 
too. Let me talk to the president of the 
company. We don’t have his number. 
Where does he live? Don’t know. Well, 
I’m not hanging up until I talk to some- 
one who can resolve this problem. 
Please hold. After a while, Heather, who 
has the patience of a saint, returned to 
report that her supervisor had autho- 
rized her to interrupt a very busy tech- 
support person, putting me ahead of 
other poor souls who were also wait- 
ing, obviously more patiently than I. Af- 
ter about ten minutes of unbearable el- 
evator soft-rock music, the tech-support 
person came on line. I described the 
problem and two minutes later had a 
Debug patch script to fix the Brief 3.1 
executable so that it wouldn’t do what- 
ever bad thing it was doing. The prob- 
lem is fixed and the computer is fine, 
but it took me a month to get a two- 
minute solution to a show-stopping, 
wall-hitting, dead-in-the-water problem. 
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And I would not have gotten it if I had 
not obstinately insisted on the support 
that was my due. 

The lesson? Before you buy an ex- 
pensive product from anyone, make a 
test run through their tech-support ser- 
vice. Call them to see how easy it is to 
get to talk to someone. If you're satis- 
fied, proceed. If not, buy elsewhere. 

Second case in point: Recently I re- 
vised a C++ book to include templates. 
To make sure that my programs were 
not compiler specific, I ran them 
through Borland C++ 3.1, Zortech C++ 
3.1, and Comeau C++ 3.0. The Zortech 
compiler wouldn’t compile some of the 
exercises. In one case, it reported an in- 
ternal error with nothing more than an 
error number. The other cases were per- 
fectly good C++ template code, which 
the other compilers accepted. I reduced 
the four problems to four very short 
code samples and posted a message on 
CompuServe in the Symantec develop- 
ers’ forum. When you join that forum, 
a cheery message greets you and 
promises 48-hour turnaround time on 
problem reports. I was on deadline and 
needed an answer. My message was ig- 
nored. After about two weeks I posted 
an inquiry and was greeted by a new 
sysop, who asked me to repost the 


problems. I did. It’s three weeks later 
now, and there’s no response. A final 
message asked them to comment. No 
response. My book will go to press with 
caveats for Zortech users. But worse, I 
am left with a bad taste that compro- 
mises my objectivity about Symantec 
products. I don’t like having my prob- 
lems ignored, and I don’t trust a com- 
pany that does that. 

The lesson? Don’t ignore someone 
who has a tech-support problem. At best 
you'll promote ill will. At worst, you'll 
be reading about yourself in the press, 
probably in letters to the editor, but 
sometimes in a column. By the way, the 
best tech support often comes from 
small companies. You may even get to 
talk to the programmer who built the 
product. Comeau C++ is an example. 
Greg Comeau is always available on 
CompuServe or by phone. 

This final tale could have had an un- 
happy ending. I could be writing this 
column from the confines of a Federal 
country club in the good company of 
lawyers, S&L executives, drug runners, 
and high-ranking government officials. 
For years I used TurboTax from Chip- 
Soft to prepare my income-tax returns. 
This year I did not upgrade the vener- 
able DOS version because that new 486 





computer included a bundled copy of 
TurboTax for Windows. Not wanting to 
wait until the last minute, I cranked it 
up fully one week before the April 15 
filing deadline. I’ve never seen a re- 
leased software product less ready for 
release. The user interface is a joke, un- 
like any CUA standard Windows ap- 
plication I have seen, and the program 
just doesn’t work. I was able to get 
enough out of it to file for an exten- 
sion, but I cannot file that return with 
our favorite uncle. It’s no surprise that 
ChipSoft’s tech-support line was always 
busy. So was their fax line. There are 
so many problems that I wrote them a 
three-page report. I couldn’t get through 
to their fax until a week after April 15th. 
Finally, the report went out, and I wait- 
ed to hear from them. Nothing. Not 
even an acknowledgment. So how does 
one get their attention? Perhaps this will 
work. If all of you fax a copy of this 
column to ChipSoft maybe someone 
there will take notice. Their fax num- 
ber is 1-800-766-8890. 


DDJ 
(Listings begin on page 148.) 
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BEFORE YOU GAMBLE ON ANY 
GUI TOOL, KNOW THE ODDS. 


C++/Browse™, a powerful object class browsing 
utility is included free. Source code is available and 
therearenoruntime se 
fees or royalties. 


With so many choices out there, figuring out what 
to look for in an application framework is no easy task. 

Call for our free white paper. It will significantly 
increase your odds of choosing the right tool for 





developing today's, and tomorrow's, GUI applications. Call us today for your 
Naturally, we think that C++/Views is your best bet. free white paper and 
C++/Views is a true object-oriented application more information on 
framework. Using C++/Views. We'll help — : 
C apes ok / Views C++/Views, your make sure you come out pe Genoa vane bd 
The best choice for multi-platform applications can be a winner. developed with C++/Views. 
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major operating environments — MS Windows, 
OS/2 PM, OSF/Motif, Macintosh, and others. 

C++/Views achieves this portability without 
sacrificing platiorm-specific features, performance, or a 
native look and feel. 


Our free white paper gives you more than 
answers, It also gives you the right questions. 
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C++ DATABASE 
DEVELOPMENT 
Al Stevens 
Al Stevens, the popular Dr. Dobbs 
columnist provides all the tools you 
need to explore the full potential of the 
C++ object-oriented language. Learn 
to use C++ to design and develop utili- 
ties and database management 
programs. Topics include database fun- 
damentals and design, database man- 





agement, building the software, and 
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2nd Edition 

Al Stevens 
Noted author Al Stevens shows you 
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using this comprehensive reference that 
includes a library of database manage- 
ment functions. 
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Diving into Windows 
Bitmaps: Part One 


ntil you look below the surface, 
you never know what you'll 
find. It was a lesson I learned 
the hard way a few months ago, 
when my wife Anne and I chartered a 
sailboat in the British Virgin Islands for 
a vacation with my parents. Despite 
getting us lost three times—not easy 
to do where the islands are so close 
and the weather so heavenly—I man- 
aged to locate a former pirate cove, 
now called “The Bight,” where we de- 
cided to anchor for the evening. By 
unanimous vote, the crew ordered the 
skipper (that’s me, by virtue of having 
read Basic Sailing twice) to snorkel out 
to the anchor and check that the hook 
was well buried in the sand. Wanting 
a swim, I happily agreed. But as I pad- 
dled away from the boat, I was dis- 
tracted by a large sea turtle swimming 
an underwater ballet along with sev- 
eral silvery fish. What a glorious crea- 
ture that turtle was! I spent many min- 
utes enjoying her beauty and imagining 
that I truly belonged there in paradise 
with her. 
Finally, remembering my job, I con- 
tinued searching for the anchor. When 
I reached it, I saw to my horror that the 


Tom Swan 


heavy plow was sitting upside down in 
the sand and had dragged along the 
bottom, allowing 38 feet of rented yacht 
to drift steadily toward the shore, now 
only a few yards away. Friends, you 
have never seen anyone swim back to 
a boat with greater haste. I should prob- 
ably get an honorary Olympic medal. 
There I was, wasting my time watch- 


Dr. Dobb’s Journal, August 1993 


ing a sea turtle and her fishy compan- 


ions while unknowingly facing untold | 


calamities in the next few minutes. Put 
it this way: Running aground definite- 
ly would have wrecked dinner. 

Eventually, I managed to secure the 
anchor and avert disaster, but the event 
reminded me of an important lesson— 
not just in sailing, but also in other en- 
deavors such as programming and de- 
bugging. In the course of investigating 
a potential problem, I had allowed my- 
self to become sidetracked by other in- 
terests, causing me to forget my origi- 
nal goal. The moral is: Stay focused. 
Get that anchor down before swim- 
ming off on new adventures. Look be- 
low the surface of your code for po- 
tential problems, and resist the urge to 
implement new features before com- 
pleting less-interesting chores such as 
testing and debugging. Boats should 
float and software should run cleanly. 
With a little care, neither should ever 
end up on the rocks. 


Bitmaps Down Below 

Peering beneath the surface of a Win- 
dows bitmap (you don’t need a snorkel, 
just a debugger) reveals several inter- 
esting facts about bitmap files and the 
algorithms for compressing them. The 
techniques are briefly described in the 
Microsoft Windows Programmer's kef- 
erence, Volume 4: Resources, but to my 
knowledge, they have never been ex- 
pressed in algorithm form. Because I 
had only that book’s sketchy descrip- 
tions to guide me, my first attempts to 
lay down the steps failed. Finally, I 
cracked the puzzle by devising a suite 
of test programs to compress and de- 
compress make-believe pixel values 





as, 


stored in plain text files. This approach 
made debugging easier, and because 
my sample test files were in ASCII, I 
could easily create and modify them 
with a text editor—far easier than cre- 
ating real bitmap files using a drawing 
program. It also was no trouble to write 
another program for creating sample 
bitmaps at random—part of a “Monte 
Carlo” test that I’ll describe next month. 
All of this advance work paid off in the 
final compression utility, which suc- 
cessfully packed a bitmap on the pro- 
gram’s maiden voyage. (Okay, maybe I 
got lucky, but anyway, it’s a real ego 
booster to write code that works on the 
first try.) 

This month, I’ll describe the Windows 
bitmap compression and decompres- 
sion algorithms and list two of the pro- 
grams in the test suite. Next month, I'll 
list the remaining test programs and the 
final bitmap compressor. Although in 
past columns, I’ve used pseudocode for 
algorithms and Pascal for sample list- 
ings, this time I'll present the algorithms 
in Pascal and the programs in C++ 
(which for other reasons, this project re- 
quired). The sample programs are not 
object oriented, so it shouldn’t be diffi- 
cult to convert them to other languages. 

A device-independent bitmap (DIB) 
file begins with various headers that de- 
scribe the image and its colors. Fol- 
lowing this information is an array of 
pixels in one of several formats. Mono- 
chrome bitmaps are stored one bit per 
pixel; 16-color bitmaps take four bits 
per pixel; 256-color bitmaps use one 8- 
bit byte per pixel; and so-called “true- 
color” bitmaps use a whopping 24 bits 
for each pixel. Most pixel values are ac- 
tually indexes into the bitmap’s color 
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Would Text and Graphic 
Printer support for over 850 
printers give you an edge? 


By including SLATE with Graphics, you 
can print Text and Graphics on over 850 
printers. Immediately! Painlessly! 


You can use SLATE in your product 
with no royalties. It gets you out of the 
printer support business. 


Make your product more functional 
and competitive by using SLATE's 
advanced text features: 

¢ Output to parallel printers, serial printers, DOS 

files and Novell network printers. 

¢ Support proportional fonts and scalable fonts. 

* Set exact print positions. 

¢ Kerning, leading, underlining, and strike through. 

¢ Automatic character set conversion. 

* Print lines and shaded areas (laser printers only). 


SLATE with Graphics adds advanced 
graphic printing features: 

* Print images from the screen, PCX or TIFF files, 

or custom image systems. 

* Print lines and shaded areas on all printers. 

* Scale and Rotate printed image. 

* Print grey scale and color images. 

* Intermix text and graphics. 


SLATE is a C or Basic library of over 
170 text printing functions, a Database 
of over 850 printers, and End User 
configuration and testing programs. 
SLATE with Graphics adds over 60 
graphic printing functions. 


Would a User Configurable 
Report Writer give you a 
more competitive product? 


SCRIPT is a full featured Text 
Formatting library that can be 
incorporated into your application. 
SCRIPT uses SLATE as its printer 
driver. SCRIPT lets you merge text, 
data, and S_PRINT formatting 
commands from ASCII files and your 
application. 


Enhance your product by taking 
advantage of SCRIPT's features: 
¢ Allow users to alter document format. 
* Set exact positions, center, right adjust, and 
decimal align. 
* Fill paragraphs from unformatted text. 
* Add lines, shaded areas, logos, signatures, etc. 
¢ Add commands and macros. 


Call or FAX now for a complete catalog 
and developer's guide for The 
Symmetry Group's printer support 
products. Order SLATE for $299, 
SLATE with Graphics for $448, or 
SCRIPT for $199 with our risk free, 30 
day return policy. 


Symmetry _ POBox26195 


Columbus, OH 43226, USA 





_ Group 
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table—a pixel p’s color equals color- 
Table[p/. In a true-color image, which 
lacks a color table, pixels directly rep- 
resent red-green-blue (RGB) colors. 
You can find more information on 
bitmap file formats in many Windows 
programming books. I'll focus here on 
a bitmap’s array of pixels and ignore 
the other information in the DIB file. I'll 
describe the compression method for 8- 


Bitmap pixels are 
compressed using 
a combination of 
three modes: 
run-length-encoded 
mode, escape mode, 
and absolute mode 





bit, 256-color images, but the techniques 
are very nearly the same for 4-bit, 16- 
color files. 


Bitmap Compression 

Bitmap pixels are compressed using a 
combination of three modes. In run- 
length-encoded mode (RLE), 2-byte 
“compression units” represent from 1 
to 255 runs of pixels, all of the same 
color. The unit 04 07, for example, 
packs 4 pixels of color 07. In escape 
mode, the first byte is 0 and the next 
byte signifies one of three special in- 
structions: 0 to mark the end of the scan 
line (the proper term for a horizontal 
row of pixels), 1 for the end of the 
bitmap, or 2 for a delta command, 
sometimes called a “move instruction.” 
Delta commands are followed by two 
more bytes that represent horizontal 
and vertical offsets to where the next 
pixel should appear. For example, the 
delta unit 00 02 05 08 indicates that the 
next pixel is to be drawn five positions 
to the right and eight down from the 
current location. Deltas are useful for 
compressing foreground images to be 
drawn on a fixed background (an im- 
portant animation technique), but they 


OA 04 | 
1 @1 01 G2 02 02 02 02 03 93 


21 @2 03 4 @5 G6 B7 O8 B9 BA 
@1 @2 @3 O4 B4 O4 M1 O2 O3 M4 
@1 @2 @1 @2 O1 G2 B1 G2 G1 G2 


Example 1: Sample “fake” bitmap 
text file. 





aren't that valuable for compressing run- 
of-the-mill bitmaps. 

In the third and final compression 
unit, called absolute mode, the first byte 
is 0 and the next byte is 3 or greater, 
representing the number of uncom- 
pressed pixels that follow. For instance, 
the absolute-mode unit 00 03 09 08 07 
encodes the three pixel values 09, 08, 
and 07. Because absolute-mode runs 
must have three or more pixels—just 
one of several undocumented quirks 
in the algorithms—different-color runs 
of one or two pixels must be expand- 
ed using RLE pairs. For example, an 
absolute run of two adjacent pixels 09 
and 07 must be encoded as 01 09 01 
07 Cone 09 and one 07). This means 
that compressed files with few same- 
color runs might actually grow in size. 
Obviously, in such cases, there would 
be nothing to gain from compressing 
the file. 

Based on these descriptions, I devised 
algorithms in Pascal to pack and un- 
pack bitmaps. (I did not implement delta 
escape codes.) As Listing One (page 
150), Algorithm #10, shows, unpacking 
is the simpler of the two jobs. The 
method reads bytes from an open file f 
and requires three subroutines not 
shown: GetByte(/) returns the next byte 
from the file, PutByte(p) displays or 
writes one pixel, and StartNewScanLine 
performs the graphical equivalent of a 
carriage return and linefeed. 

The algorithm for packing a bitmap 
is fairly complex, so I decided to im- 
plement the parser using a state ma- 
chine, which helped organize the code 
into manageable chunks. Several con- 
stants at the beginning of Listing Two 
(page 150), Algorithm #11, describe var- 
ious states that the machine can assume. 
The algorithm requires two input val- 
ues: an Integer 7p set to the number of 
pixels per scan line and an array of un- 
compressed pixel bytes; and s/, repre- 
senting one scan line of the image. The 
method uses a While loop and a Case 
statement to implement the state ma- 
chine. Each labeled case represents one 
state: READING examines the current 
pixel and determines what to do next; 
ENCODING packs same-color pixels 
into RLE units; ABSMODE packs dif- 
ferent-color pixels as absolute-mode 
runs; SINGLE handles absolute-mode 
runs of one or two pixels; and END- 
OFLINE marks the end of a compressed 
scan line. 


Test Suite 

Like most complex algorithms, the two 
listed here might seem obscure if you 
simply read them from top to bottom. 
To better understand the methods, do 
as I did: Process sample bitmap data in 
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text files, as illustrated in Example 1. All 
values are hexadecimal bytes. The file 
begins with an information line of two 
bytes representing the number of pix- 
els in a scan line (OA hex here) and the 
number of scan lines in the image (04). 
The next several lines give the pixel val- 
ues for each scan line. 

Listing Three, TUNPACK.CPP (page 
150), implements Algorithm #10. Listing 
Four, TPACK.CPP (page 151), imple- 
ments Algorithm #11. Both programs 
write to the standard output file. To run 
the tests, store Example 1 in a text file 
named TEST.DAT, then enter the DOS 
command: 


TPACK TEST.DAT >PACKED.DAT 
To unpack the result, enter: 
TUNPACK PACKED.DAT >FINAL.DAT 


If the test passes, the values in FINAL.- 
DAT should be the same as those in 
TEST.DAT, minus the original file’s in- 
formation line, which TUNPACK does 
not recreate. 

Although TPACK and TUNPACK do 
not operate on real bitmap files, they 
simplify debugging and testing, and they 
might also be useful for porting the al- 
gorithms to other languages and oper- 
ating systems. Writing data-compression 
software is a nerve-wracking business, 
and it’s vital to do everything possible 
to ensure that compressed files are com- 
pletely recoverable. You can’t perform 
too many tests of a data-compression 
utility. 


Your Turn 
I wrote the sample programs in this col- 
umn for DOS in order to keep the list- 
ings short. If anyone cares to rewrite 
the programs for Windows, I’d be in- 
terested in receiving them in care of 
DDJ. Or, you can upload files (com- 
pressed text only, please) to my Compu- 
Serve ID, 73627,3241. Next month, I'll 
list the rest of the programs in the test 
suite along with the final utility that can 
compress real Windows bitmap files. 
Meanwhile, I wonder where that sea 
turtle is right now and whether she no- 
ticed my panicked race back to the boat. 
Call me paranoid, but I can’t shake the 
image of a smart-aleck turtle going 
around harbors, pulling up anchors, and 
watching the fun. You don’t suppose 
that’s possible, do you? Nah. 


DDJ 
(Listings begin on page 150.) 


Vote for your favorite feature/article. 
Circle Reader Service No. 13. 
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DOS - SCO - SUNSOFT - P9000. RS6000 - 880PEN - BANYAN - MAC - QNX 
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Expensive 
DBMS Servers 
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Affordable 








FairCom Offers A Full Line Of High-Performance Servers 
_ & Development Tools At Reasonable Prices. 


FairCom Servers 
SQL &non-SQL | 
These multi-threaded eobass servers 


offer a seldom-found solution for 


developers who demand control. While 
one may mandate SQL access, 
another's real-time demands may not 
tolerate the overhead associated with 
SQL. Our unique servers offer the full 
range of data accessibility: low-level 
speed; convenient ISANHevel; | 





Complete data integrity is achieved 
with multi-user transaction processing. 
Recovery of all committed transactions | 


~ after a failure is fully automatic. The C 


developers ‘CLIENT/SERVER ' solution: 
DOS nodes to UNIX servers; full 
commit and rollback; roll forward; 


precise control over your data and/or 


data base model; large files — 
~~ client source: code. 


d-t ree Tool box 
Application Development 
Productivity tools with: a complete 
portable screen handler; data 
dictionary; code generation; easy to - 


_use data base interface; menus; ne 
text; data validation. d-tree' s 


dynamics allow runtime control of 
program resources (screens, files, 
edits, etc.) not found in any other 


_ development package. Resources can 


be changed in memory, and/or 
swapped on/off of disk at runtime. If 
you do application development on 
multiple platforms (DOS/UNIX), or 
you're debating 4GL versus C 
development, d-tree is for you. 


c-tree Plus 


High Performance Data Management 


‘Based on the most advanced B+ Tree 


routines available today, c-tree Plus gives 
you unprecedented control over your file 


- management needs. With unparalleled 
sophistication, c-tree Plus has established 


itself as the premier choice for commercial 


development. Use the low-level routines or 
_take advantage of the high-level ISAM 
_ routines for high speed random or 
sequential access. c-tree Plus is 


distributed in complete C source code 
and is known for its portability and 


_ royalty-free licensing policy. Whether for 
_ single-user, multi-user or client-side 
application development, c-tree Plus 
delivers. Transaction processing is 
included in c-tree Plus- call ae a complete 
- ist of features. 


Natur al Query 
_ Natural Language Tool 


Produces ad hoc reports quickly and 


easily from English sentences. It is the 


first low-cost, natural language tool 
designed for developers. The QBE option 


_ has easy-to-use, pick and choose menus, 
_ making report specifications a snap. 
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A” your DOS applications starting 
to show signs of age? If so, it’s time 


to do some remodeling. With our new 
C/Windows Toolchest™, you can easily 
create interfaces for your DOS applications 
that are similar to 
Microsoft® Windows™ 
applications. | 
Two simple ars. | - 
function calls are tri- 
all it takes to create 


~ 


Energize Your DOS Applications 
with a Windows-Style Interface 


isin taiidiciceeteaciattaicaiis coseetErssessroc¥ ay 
CAdindows Toolchest functions vork in either 

text or graphics mode. 
select from 7 text modes: 12, 14, 21, 25, 28, © 
43, or 58 line mode. 





entry forms. Use picture clauses to build data 
entry templates. Valid input may be enforced 
automatically, or you can define your own 
input validation functions. 

Handling mouse input is easy. There are 
numerous high level 
mouse functions, 
including one that 
retrieves all mouse 
events and key- 
strokes. Mouse 


window-1 doc ssssesscsss==ny 44 
== window-2 doc == ee 
For text applications, 3 


For graphics, select 


“=| from 6 graphics modes: 328x268x16, 640x288x16 
b48x358x16, 640x48@x2, 648x480x16, or 
Z2Ox348x2. Graphics applications may select 

bi 

atte * 


movable, resizable 
windows, complete 
with scroll bars and 
other standard 
controls; including 
minimize, maximize, 
restore, and menu 
buttons. A wide 
variety of other 
controls are also 
available; including 
push buttons, radio buttons, and check boxes. 

Of course there is extensive support for 
menus. Create horizontal and vertical menus, 
with or without scroll bars. Arrange menu 
items in a single row or column, or in multiple 
rows and columns. Attach a sub-menu to any 
menu item. 

For collecting user input, you get a 
comprehensive set of functions to manage 
data entry fields. Collect data one field at 
a time, or all at once through complete data 


Now One Interface Library Lets You Create 





input is handled 
automatically by 
control buttons, 
menus, and data 
entry fields. Low 
level mouse 
functions are also 
provided just in 
case you need 
them. 

In all, the 
C/Windows Toolchest™ contains more than 
250 functions to help you design a state-of- 
the-art user interface. Included are functions 
for implementing context sensitive help, 
keyboard control, and graphics. You also 
receive the complete source code for a 
multi-window Notepad editor that works 
in both text and graphics mode. C/Windows 
Toolchest™ works with C and C++ compilers 
from Mix®, Borland®, and Microsoft®. 


d fonts: 8x8, 8x14, or 8x 
windou-4 doc =" 
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SALES BY REGION 


Both Text and Graphics Mode Applications 60 Day 
Money-Back 
i Guarantee 
_) Please send FREE brochures (J C/Windows Toolchest.......... $39.95 | 70: 60 aes 
Disk Size: 5.25" 3.5" L) Library Source... $10.00 ! | 


(Requires DOS 2.0 or higher) 


(Source code for C/Windows library ) 


Paying By: ) Check or Money Order 


, 
I 
4 
: 
i 
, Name Shipping & Handling. | 
| Company ($5 USA, $10 Canada, $20 Foreign) 
i 0 
Street Texas Sales Tax (8.25%) 
1 City Total Amount of Order........... $ 
i 
State Zi 
' P LU) Visa LmMc LU) Amex UU Discover 
I Country Card# 
Telephone Exp. Date 





To Order Please Call: 


1-800-333-0330 


Orders or Technical Questions: 
Tel: 1-214-783-6001 
Fax: 1-214-783-1404 


Mix Software 

», 1132 Commerce Dr. 
Richardson, TX 

75081 
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UNDOCUMENTED CORNER 


The Windows 
.RES File Format 


by Alex G. Fedorov and 
Dmitry M. Rogatkin 


Introduction 
by Andrew Schulman 





ly but fundamentally different from the format of resources 
within executable files. 
Instead of a resource table, a .RES file is simply a concat- 


The “Undocumented Corner” seems to be on a Windows 
file-format roll. Last month, Mike Maurice explored the .PIF 
file format. Next month, Peter Davis and Ron Burk will un- 
cover the long-concealed .HLP file format. This month’s 
“Undocumented Corner,” which comes to us from Russia 
(the authors are regular contributors to the Russian-language 
magazine ComputerPress, published in Moscow), reveals 
the Windows .RES file format. 

Windows .RES files are produced by the Windows re- 
source compiler (RC) and contain the binary images for 
Windows resources (menus, dialogs, and so on) prior to 
their inclusion in an executable file. While Microsoft has 
documented “Resource Formats Within Executable Files” 
(Microsoft Windows 3.1 SDK, Programmer's Reference, 
Volume 4: Resources, Chapter 7), it has not publicly docu- 
mented the .RES format—that is, the resource format outside 
executable files. While resources within an executable are 
located using the “Resource Table” (see section 6.2.3 of the 
SDK, volume 4), .RES files contain no such resource table. 
As Alex and Dmitry explain, the .RES file format is slight- 


enation of individual resources, each of which has its own 
small variable-length header. Alex and Dmitry document 
the format for this header. Since there’s no central header, 
there’s no way to determine with 100 percent reliability that 
you actually have a genuine .RES file. Yuck! In any case, 
aside from the header on each individual resource, the re- 
sources in a .RES file are identical to those in an .EXE file. 

Originally, Alex and Dmitry’s article also discussed the 
format of .BMP (bitmap), .CUR (cursor), and .JCO (icon) 
files, but ’ve skipped over this discussion, as this materi- 
al is already documented by Microsoft in Chapter 1 (‘Graph- 
ics File Formats”) of the 3.1 SDK, volume 4. 

The .RES file format makes an interesting case study of 
why some important interfaces are undocumented. First, Mi- 
crosoft has already produced a limited-circulation document 
(“Microsoft Windows 3.0 Internal Resource Formats,” Novem- 
ber 12, 1990) on this subject, so the lack of public docu- 
mentation can’t be attributed to a lack of sufficient resources 
(as it were) in Microsoft's documentation department. The 

(continued on page 134) 


hile most of the file formats 
used in the Microsoft Win- 
dows environment are doc- 
umented (although not al- 
ways adequately), the format of .RES 
files, which hold resources before their 
inclusion in a Windows executable file, 
has been obscured by a curtain—un- 
til now! Knowing this format can help 


Alex G. Fedorov is a freelance program- 
mer and an executive editor for Com- 
puterPress magazine in Moscow, kussid. 
Alex can be contacted at alex@comput- 
erpress.msk.su via the Internet. Dmitry 
M. Rogatkin, a freelance programmer 
specializing in Windows software, is a 
lecturer at the Moscow Institute of Elec- 
tronic Machinery. Dmitry can be con- 
tacted at datasc@adonis.ias.msk.su. 
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developers to load and unload re- 
sources on the fly, in interactive pro- 
gramming environments, for example, 
or in commercial applications with 
user-programmable macro languages. 
This article explains how stand-alone 
Windows resources are organized and 
provides a set of utilities that shows 
how to use them. 

It is important to note that much of 
what .RES files contain is already doc- 
umented. The files contain the binary 
images of resources, in the format doc- 
umented in the Windows 3.1 SDK. 
What needs to be discovered in .RES 
files are the surroundings for the already- 
documented binary resource images. 

To uncover these magic cookies, we 
can use a text editor to create a resource 
script, pass it through the resource com- 





piler (RC), and use a hex-dump utility 
to study the contents of the resulting 
RES file. Listing One (page 153) shows 
a simple TEST.RES file, and Figure 1 
shows a partial hex dump of the re- 
sulting TEST.RC file produced by RC. In 
the ASCII display on the right side of 
the hex dump, many of the strings from 
TEST.RC, such as BARFOO and FOO- 
BAR, are plainly visible. 

Figure 2 shows an analysis of the hex 
dump. Each resource within the .RES 
file may start with the byte OxFF, which 
tells us that the next word is a numer- 
ic resource type. The predefined re- 
source types, such as RT_CURSOR (1), 
RT_BITMAP (2), RT_ICON (3), and so 
on, are listed in WINDOWS.H. (Type 
16 is listed in VER.H.) Unlisted resource 
types are user defined. Any starting byte 
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documentation already exists, and has simply not been made 
public. Yet, for reasons that will soon become clear, I don’t 
think this is a simple case of “they’re hiding it from us.” 

The Microsoft “Internal Resource Formats” document was 
made available to independent software vendors SVs) on 
a limited basis as part of the Microsoft Open Tools effort. 
Despite its name and good intent, Open Tools appears to 
be limited to only the largest and most important ISVs. Many 
of you have complained about never having been able to 
pry the (therefore somewhat misnamed) Open Tools mate- 
rials out of Microsoft. I’ve previously dismissed this as unim- 
portant, since the Windows 3.1 SDK incorporated almost ev- 
erything previously available only through Open Tools, but 
I now see that at least the .RES file-format documentation 
from Open Tools was not brought over to the 3.1 SDK. 

The Open Tools document refers to the .RES file format 
as a “proprietary binary format,” and explains that “Until 
now, the .RES file format has been undocumented. This 
was mostly because its structure was version-dependent 
and changed frequently.” Fair enough. Apparently, the rea- 
son for documenting it as part of Open Tools was that, 
since much of the .RES file contents are copied directly 
into .EXE files, this helped document the more-important 
format of resources within .EXE files. Presumably, because 
Microsoft later went all the way and properly document- 
ed resources within .EXE files, it didn’t bother publicly 
releasing the documentation for resources within .RES files, 
which it seems to consider merely an “intermediate file” 
of little intrinsic importance. 

My favorite Microsoft product, the Microsoft Developer 
Network (MSDN) CD-ROM, does provide several crucial 
snippets of information about the .RES file format, yet still 
fails to fully document it ather amazing, considering what 
we'll see is the utter simplicity of this format). First, the 
MSDN CD does properly document the Win32 .RES file 
format, including a brief note on how (using illegal type 
and name ordinal numbers) to distinguish Win32 from 
Win16 .RES files. (This same document, by Floyd Rogers, 
may be found in RESFMT.TXT on the Win32 CD-ROM.) 
Second, the MSDN CD includes the source code for 
RESTOOL, a program that reads in Windows .RES files and 
generates C++ class declarations for any dialog boxes in 
the .RES. While no other resource types are handled, this 
demonstrates the basics of walking through a .RES file. 


All this is fairly typical of Microsoft's extremely annoying 
(but not very nefarious), half-hearted approach to docu- 
mentation. Rather than some deliberate master-minded at- 
tempt to deprive software developers of information, we 
see almost the exact opposite: an almost complete lack of 
deliberateness. Unlike the example of, say, the MS-DOS net- 
work redirector, Microsoft has in the case of the .RES file 
format made no particular effort to either hide or provide 
this information. It’s not a conspiracy; it’s just stupidity. 

That Microsoft dances around the issue so much, inad- 
vertently documenting little bits of the .RES file format on 
a piecemeal basis, but (very likely also inadvertently) not 
documenting the whole thing once and for all, does indi- 
cate that this simple little format is at least somewhat im- 
portant. Besides its use by programs such as RESTOOL, 
knowing the .RES file format would also allow interactive 
programming environments to load .RES files on the fly. 

Once a Windows program has located a resource in a 
.RES file, how could a Windows program load it? The Win- 
dows API includes resource-handling functions such as 
CreateDialog, LaadMenu, FindResource, and LoddkResource, 
but these only work off of executable files. How can a re- 
source be loaded from something other than an executable 
file? The Windows API includes documented functions such 
as CreateDialogindirect and LoadMenuIndirect to create cer- 
tain resources from binary resource images in memory. For 
example, Microsoft Excel uses these functions to let a user’s 
macros create menus and dialogs on the fly. Similarly, once 
a menu or a dialog in a .RES file has been located and read 
into memory, these same /ndirect functions can be used to 
transform the binary data into a bona fide Windows resource. 

Unfortunately, there isn’t an equivalent /ndirect function 
for every Windows resource type. However, Alex and 
Dmitry’s sample code (too long to include with this article, 
but available electronically, see “Availability,” page 5) pro- 
vides functions such as LoaddRESAccelerators and LoadRES- 
Bitmap that fill in the gaps. This code may also be useful 
to those working with self-loading Windows executables. 

As usual, please me send comments, suggestions, criti- 
cisms, and any interesting gossip about Microsoft trade 
practices. My e-mail address is 76320,302 on CompuServe, 
and andrew@pharlap.com on the Internet, you can also 
reach me on MCI Mail. 


other than OxFF is the first character in 
an ASCIIZ (0-byte terminated) resource- 
type name. 

Following the resource type comes 
either the resource name, stored as an 
ASCIIZ string, or an ordinal ID, stored 
as a number. Just as with the resource 
type, if the first byte is OxFF, the re- 
source is identified by number rather 
than name, and the next word is the 
ID itself. 

The next two fields are memory flags, 
stored as a WORD, and the resource 
length, stored as a DWORD. The mem- 
ory flags are usually 0x1030 indicating 
(MOVEABLE | PURE | DISCARDABLE), 
or 0x0x30 indicating (MOVEABLE | 
PURE). The resource length is for the 
actual resource, and does not include 

(continued on page 138) 


.Cmd &2...&Anoth 
er test...o.Cmd 
&il...p.Cmd 612. 





Figure 1: Hex dump of TEST.RES. 
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C CODE FOR THE PC 


source code, of course 


CDFS (CD-ROM File System for Embedded Applications; High Sierra and ISO-9660 Level 1; portable C with simple device interface) . . . $750 
Embedded DOS (full-features, real-time, multitasking, 3.31-compatible DOS for embedded system and self-bootable installations) . . .. . $375 
ChartPro (Windows DDLs to add bar, pie, line/area, and ap 7h te chart to your apps: user Giniogs Included) .... 6k bs ee Ee we wwe $350 
X/DOS and Xt/DOS (Xlib with X client and Xt toolkit for DOS; port X code to DOS; Xt/DOS requires OS and 32-bit compiler) . . each ee 


Code Base 5 (database manager, dBase and es re eae indexes & data files; Version 5.0; eat COUR) ee Ww od ee we 
/ 


ZIP Image Processor & Victor Image Library Version 2. Nel caer ray contrast, merge images, TI /PCX/bin, HP ScanJet support) . . $290 
The Snooper (Ethernet ee. analyzer for Novell NetWare and LAN Manager Networks; capture packets; real-time display) ...... $275 
Turbo (Release 3.0; HP, PS, dot drivers; CM fonts; LaTEX; MetaFont) . . 2. 1 1 1 ee ee ee ee ee ee $250 
ue Wave tools.h-+-++ or math.h++ Class Library (extensive docs) . 2. 6 6 1 oe ee each $240 
++ Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, database functions, Jolt Award winner) ...... . $170 
c_pslib (PostScript generation library for C programs; includes complete graphics, font, rotation & paragraph support) .......... $170 
Editor Developer’s Kit Ver. 3.0 (full screen editor, undo command, multiple windows; with Word Processing $530) ie we oe ee Pw $155 
Minix Operating System (Version 1.5; Unix-like operating system, includes manual; 3.5” diskettes only)... .. 2... 2 ee ee eee $150 
Delorie GCC for MS-DOS (Version 2.2.2; includes C+ +, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 
Ibrow (Version 4.1; programmer’s Windows-based editor; large files, help, undo/redo, drag-n-drop, function & type tags) ......... $135 
Booter Toolkit (floppy disk bootstrap routines, DOS file system, light-weight multitasking, windows, fast memory management) ...... $120 
Dr. MD (runtime memory spon & rie er, find many memory corruption errors; examine memory a a ee a eee $110 
ar for DOS (Kyoto Common Lisp and CLISP; KCL includes Lisp-to-C translator for building mixed Lisp/C programs) ......... $100 
D Version 0.1 & LINUX Version 0.96 (two Unix clones for Intel sa ee + Oe ee oe ee eee ee ee ee EM OR $100 
PC/IP (CMU/MIT TCP/IP for PCs; Crynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 
Demacs (complete GNU Emacs for DOS; needs djgcc to build; based on 18.55). 6 1 6 1 ee ee ee $100 
Script Interpreter iS command script interpreter for DOS-based systems; C-like script language; lots offeatures). .........4... $90 
HorC++ Power (C++ Class Library for Borland’s Paradox Engine) . . 2. 1 1 6 6 ee ee ee ee ee et $80 
CPPCOMM (Version 3.0; C++ serial communications class library for DOS, Windows, OS/2, and NT; includes X/Y/Zmodem) ...... $75 
ET Neural Net (back error propagation; specify DOS text, DOS VGS, or Windows) . . . 2. 6 1 6 ee eee ee ee ee ee $75 
FlexList (doubly-linked lists of arbitrary data with multiple access methods; specifyC orC++) .. 2... 2 ee ee ee ee ee ee ee $65 
Smalltalk for DOS (port of GNU Smalltalk using djgec) . . - 6 6 we ee ee $60 
LDB (Loose Data Binder, portable, persistent container of arbitrary data including pointers)... . 2... 1 ee ee eee eee $60 
Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic) .. . 2... 1... eee ee ee ee ee $60 
Coder’s Prolog (Version 3.0; inference Se ay forse With C prosrams): <4. 6.4 4. we 4 Se 6 ew Se Om ee eK ee ED ee $60 
PCCTS ae. Compiler Construction Tool Set; ported to Microsoft C; like YACC and LEX together with lots of additional features) . . . $60 
MEM-.WING (global memory manager for Windows, supports standard C memory allocation calls to wing” your old C code into Windows) . $55 
BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion) . .. .. 2... ee ee ee ee ee es $50 
EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easilyextended) ....... $50 
Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption) . . . .. 2... 6 1 ee ee ee ee $50 
Saperaren (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories) . . 2... 1 2 ee ee ee eee ee $50 
Moby ar a (Volume 1: DES, Lucifer, SRNG, ARNG; Volume 2: PGP, RSA, MD4, SHA; both volumes $75; not forexport) .... . each $50 
OBJASM (convert .obj files to .asm files; output is MASM compatible) . 2. 1 1. 1 1 we eee ee $50 
CLIPS Version 5.1 (rule-based expert system generator, advanced manuals available at additional cost)... ........-+-2-+--. $50 
NIH Class Library & Book (basic C+-+ classes & Data Abstraction and Object-Oriented Programming in C+ + in softback by Keith Gorlen) . $50 
Editor Pack (20 public domain editors; microEmacs 3.11, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF) ......... $50 
MicroC C Compiler (retargetable C compiler/optimizer, lots of docs, very portable, 8086 tables included; tables for 7 extra cpu’s $50) . . . . $50 
PICTOR (Video library: multi-pane windows, menus, hypertext help, serial communications; text editor example; muchmore)....... $45 
TOUR (beautiful traveling salesman problem solver, finds minimum length paths quickly, includes graphics & poe programs) ..... $40 
DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; not forexport) ......... $40 
Database Pack (9 databases — simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres) ............ $35 
COP (poor man’s C++; C macro package which implementsC++inC) .. 2 1. 2 1 ee eee ee ee ee ee ee $35 
RXC & EGREP Version 2.0 er oe Expression ea ee and Pattern Matching; finite state machine from regular expression) ..... . $35 
Bison & BYACC (YACC workalike parser generators; documentation; includes C and C++ grammars) ...........4+4.24 48. $35 
Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) . . . $30 
Alloc-GC (a garbage-collecting memory allocation library). . ©. 2. 6 1 6 1 ee ee ee ee ee $30 
REGX Plus (Version 3.0, search and replace string manipulation routines based on compiled regular expressions) ............ $30 
GNU Awk & Diff for PC (both programs in one age) ie Kl ee ee HO Le oe ee oe ee ee ee ee ee $30 
Big Number Pack C arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter isincluded) ....... $30 
Crunch Pack (30 file compression & expansion programs; now includes portable ZIP) . . 2. 1. 1 1 1 ee ee ee ee ee ee ee $30 
Exceptions for C (Ada-like exception handling for C programs; exceptions for any block; exceptions can be reraised) ........... $30 
OEmacs (full GNU Emacs for DOS and Windows DOS box; C+ + support, etags++,lotsof.elfiles) . 2... 2... eee ee eee $25 
UUPC Pack (UUCP for the PC; UUPC Version 1.11V, smail & snews) .°. 2... 1. 1 ew ee et we we we we we ww we we ewe ew wwe $25 
PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs) ..........4... $25 
FLEX (fast lexical analyzer eg pal new, improved LEX; BSD Version 2.3.6 with docs) ... 1... 1 6 eee ee ee ee ee $25 
GNU RCS (FSF’s version of the Revision Control System; like Unix’s SCCS only better; keeps track of software development) ...... . $20 
Simple Socket Library (Unix, VMS and MS-DOS; sits on TCP/IP stack) ©... 6 6 6 ee ee ee ee ee ee $20 
Bywater BASIC Version 1.10 (complete BASIC interpreter and interactive programming environment)... ... 2... ee ee eee $20 
Data 
Moby Thesaurus (25K root words, 1.2M synonyms)... 2 6 6 6 ee ee $350 
Moby Part-of-Speech (200,000 words and phrases described by prioritized part(s)-of-speech) . . 2... 6 1 eee ee ee ee ee ee $120 
Moby Words (500,000 words & phrases, 9,000 stars, 15,000 names) . 2 2. 1 1 1 we ee ee ee $80 
Moby ea (Pays. sonnets, Ctc. ... €very IaSt WO) «0.6 6 ces eh OE ee le we we HS OH ew ew 8 $60 
Dictiona ord List (234,932 words in alphabeticalorder) .. 2... 56 2 see eee wee eee ee eee were ees ees $60 
POGCTO ISLE TheeaUIS. <6 ce ke de 419 ee ee oe OS ew ee EW ee eS ee Be we SHY ew $40 
U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points). . . . 2... 2 1 ee ee ee ee ee $35 


CIA World Bank II Database Saat of maps, 5.7M vectors; coastlines, rivers, political boundaries; Africa, Asia, Europe, N. & S. America) . en 


The World Digitized (100,000 longitude/latitude of world country boundaries) . . . . 1. 2 1 1 ee eee ee ee et he ee 

Lots ’O Words (160,086 German, 178,430 Dutch, 61,843 Norwegian, 60,453 Italian, 138,257 French, 53,142 English) ........4... $30 
CD-ROMs 

FontMaster Library (soft fonts for HP and HP compatible laser printers, 36 different type faces; 5,200 bit mapped fonts; 300MB) ..... . $70 
Prime Time Freeware (Volume 2, No. 1, January, 1993; over 1 gigabyte of Unix Ccode) . . 2... 1 1 1 eee ee ee te ee $60 
Linux/GNU/X by Yggdrasil ayers A beta release; run from the CD; TCP/IP & NFS; drivers; MPEG; SCSI support; lots more) .... . $60 
Walnut Creek Libris Britannia (over B of the best of British boards; not all source included) ....... 1... 2 ee eee eee $55 
InfoMagic Unix (386BSD Version 0.1, Linux, X including contributed, complete GNU, 2nd Berkeley Networking) ............ $50 
InfoMagic Internet (RFC’s, IEN’s, Netinfo, 2nd Berkeley Networking, packet drivers, GNU, X, ISODE 8.0, DOS Emacs & C/C++) ... . $50 
Walnut Creek C Users Group (Volumes 10010364) ok 8s 6 6 RE CESS ODE OEE OH $40 
Walnut Creek XIIRS and GNU (X11RS5 with contributed and comp.sources.x, over 120 GNU programs, complete Csource) ........ $35 
Wainut Creck Usenet and Simtel Unix-C (GO0MB) . «6 5.6 seek hb Rew we Oe ee ee eee ew we $35 
Walnut Creek Simtel 20 MSDOS Archive (C source code but lots of other stufftoo) . 2. 1 2 6 1 we ee ee ee ee ee ee ee $20 
Sprite Network Operating System (source code & documentation of Ousterhout’s Sprite O/S; Sun and DECStation boot images). .... . $20 
The Austin Code Works Voice: (512) 258-0785 
11100 Leafwood Lane much more ... ask for catalog FAX: (512) 258-1342 
Austin, Teras 78750-38587 USA E-mail: info@acw.com 
Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA 
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1993 CONFERENCE & EXHIBITION 


The software industry is changing. 
Businesses are rightsizing, new GUI plat- 
forms are in the news, and software and 
operating platforms are becoming ever 
more important variables in today’s busi- 
ness computing equation. 

You have a lot to keep up with today. 
So, we're retooling two great industry 


events to help you do just that. 


WINDOWS & OS/2 
BECOMES BUSINESS 
SOFTWARE SOLUTIONS 
First , Windows & OS/2 has changed its 
name to Business Software Solutions. 


Why? To let you know we're keeping up 





Business Software 
Solutions 


CONFERENCE & EXHIBITION 


OUR NEW GOOD LOOKS 
ARE NICE, BUT IT’S WHAT'S 
INSIDE THAT COUNTS. 


with your growing need to bring 
cost effective GUI-based solutions to 


your business, 


At Business Software Solutions you'll 


vet the best of the old Windows e OS/2 






ate ess 
Conference. You'll still find the hottest 
software for today’s key GUI-based plat- 
forms. You'll find test drive centers where 
you can try out apps before you buy. And 
youll find many of the biggest name 


industry gurus telling you like it is about 


what's hot and what's not. 

But weve added so much more, you'll 
barely recognize the place! 

First, we've rebuilt the conference 
program from the ground up to provide 
you with much more value. Whether you 
manage your own business, or work for 
one of the Fortune 500, you'll find the 
answers you need about todays GUI- 
based platforms and software. 

You'll discover how to make sound 
buying decisions that insure your invest- 
ment as technology changes. You'll learn 
whether or not it’s a must to settle on just 


one platform for your business. Youll 





learn how to set up and manage multiple 
platforms over a network. 

Then, you'll find how to use the most 
cost-effective training tools and techniques 
to support and train your end-users. You'll 
discover how to give your enterprise easy 
access to legacy data on the desktop. And 
youll learn how to build Windows and 
OS/2 solutions that meet the real needs of 
your end users. 

On top of that, we've added a 
Solutions Interchange Room where you 
can trade ideas with peers, a Solutions 
Theatre for head-to-head vendor demos, 
and much more! 

All in all, you'll find the whole event 
focused on how to help you solve your 
biggest end-user computing problems 
using the best of today’s desktop technolo- 
gy PLUS you'll get a glimpse into what's 


coming next after Windows and OS/2. 


SOFTWARE DEVELOPMENT 
?93 JOINS BUSINESS 
SOFTWARE SOLUTIONS 


Take the newly refocused Business 
Software Solutions Conference and add 
the largest and most respected technical 
conference and show for anyone involved 
in building desktop or client-server appli- 
cations. What have you got? A dynamic 
industry event that reflects the entire desk- 
top software process from development to 
final applications and solutions! 

SD has long been seen as the best 


place to get unbiased, here's-how informa- 


tion on developing for the desktop. With 


over 150 courses in tracks ranging from 
Windows, OS/2 and UNIX development, 
to Analysis & Design, C++, Client-Server 
development, User Interface Design and 
Management, you'll have a hard time 
choosing which sessions to attend. 

And, again, that’s not all. On the 


show floor youll see the best available 


SOFTWARE 


ill 
SOFTWARE 


DEVELOPMENT '92 


DEVELOPMENT 





WE CHANGED OUR 
LOOKS TO GET YOUR 
ATTENTION... 


But we know that it's what's inside that 
counts. And whether youre interested in 
the solutions side or the development side 
of the desktop software equation, at 
Software Development and Business 
Software Solutions you'll find answers to 
more of your business software questions 
than ever before in two quality confer- 


ences and more than 250 exhibits. 


To get detailed information on what 


youll find when you arrive, return this 


Come SEE FOR YOURSELF. AUGUST 23-27 IN 


BOSTON AT THE HYNES CONVENTION CENTER. 


development products from leading tools 
vendors. SD was the site of Borland’s 
launch of Borland C++ last year, and 
Microsoft’s Visual C++ and 40 other 
new products this 
February. This August 
youll find more of the 
hottest tools on the 
market. And, you'll get 
an extra bonus. That's 
because your SD ticket 
also gets you into 


NAME 


Business Software 
TITLE 
Solutions, the software 


COMPANY 
solutions showcase of 


the summer. nmi 


CITY 


PHONE 





coupon, phone us at 415-905-2784 or fax 


us at 905-8100 today. We'll send you a 
complete conference catalog, and a ticket 


for a free show pass. 


Please send me more information about your 
two conferences & exhibitions being held 
concurrently in Boston, August 23-27, 1993. 


_J Business Software Solutions 


1 Software Development 


MAIL STOP 


STATE ZIP 


FAX 


Miller Freeman, Inc. 


600 Harrison Street « San Francisco, CA 94107 
415-905-2784 « FAX 415-905-8100 





Private Tutor 
Teaches C... 


Whether you want to learn C or 
you're helping others to use this 
general-purpose language of com- 
puting, you need the C Workshop. 


Within minutes you'll write C code— 
even if you’ve never programmed 
before. Use the built-in editor, C com- 
piler and pop-up help. When your 
program exercise runs, feedback as- 
sures you it produces correct results or 
gives you an example of any problem. 
In 109 exercises, the tutor gives you per- 
sonalized feedback on what you write. 


. 
. 


Amazing 
feedback 
guarantees 
mastery of 
C 


You get all the software plus our coor- 
dinated 376-page book. Here’s the 
clearest presentation of C pointers 
there is. The C Workshop covers it all, 
from the basic idea of structured pro- 
gramming to advanced operator com- 
binations. Naturally, it teaches ANSI 
Standard C. 


Everything you learn works in all the 
popular C compilers. Meanwhile, use 
the C Workshop to create your own ex- 
ecutable programs (up to 64KB). 


ComputerWorld columnist William 
Zachmann advised, “I'd offer the 

C Workshop, an extremely well-done in- 
structional package, to anybody on my staff 
who wanted one.” 


Why buy three books and two com- 
pilers? The C Workshop tutorial with 
compiler, feedback, and book is only 
$89 (5 1/4" MS-DOS; add $2 for 3.5") 
plus $5 ship. For all IBM PC com- 
patibles. Call toll-free 9-5 Pacific time 


1-800-762-8003 


Or write to Wordcraft, 3827 Penniman 
Ave., Oakland, CA 94619. 


UNDOCUMENTED CORNER 


(continued from page 134) 

the header; this length is used to get to 
the next resource in the file. These two 
fields complete the resource header. 
They are followed immediately by the 
resource data itself, which is in the same 
format as documented in the Windows 
3.1 SDK, Programmer's Reference, Vol- 
ume 4: Resources, Chapter 7. 

The .RES file is simply a collection 
of resources. There’s no signature at 
the start of the .RES file, so any kind 
of file can be supplied to a resource 


utility (and kill it). On the other hand, 
the absence of a .RES-file signature 
means that you can simply concate- 
nate .RES files with the COPY /B com- 
mand. While this allows you to com- 
bine a set of small .RES files into a 
single larger one, a problem can oc- 
cur: The resulting file may end up with 
more than one resource of the same 
type and ID. 

While a .RES file is simply a con- 
catenation of individual resources, in 
Windows 3.0 the resource compiler 


Tagl 
Res Type (3 = RT_ICON) 
Tag2 


Resource ID (#1) 
Resource Flags 
| ) rT 6h. Resource Length (@x02E8) 
Start of ICON data 


| FF 03 00 FF 01 00 30 10 E8 02 OB OO 28 00 OH OO ...... Oot ses ere 
! 
| 


20 2 BD BB 40 OB BH BO B1 BD G4 BO BO BO BH BO | 


...@ oe eee eee eee 


this hdr size (3+3+2+4=0x@C) + res length (@x@2e8) = 


res at Ox@2f4 


Tagl 

Res Type (14 = 
RT_GROUP_ICON) 

Res Name (“BARFOO”) 


[_ Resource Flags 


GE Q@ 42 41 52 46 4F 4F OO 30 10 | 
@D G1 OO G1 OB 2H 20 10 BH G1 BO |! 


Resource data 
Resource Length (0x14) 


More resource data 


Tagl 
Res Type (5 = RT_DIALOG) 


@4 OD E8 02 BD OO G1 OO FF O5 OO 46 AF 4F 42 41 | 


52 0@ 30 10 4E GB BH BB BB BH CO OO O2 OA OD 14 | R.O.N........... 
start of binary dlg data 
Res Length (@x4E) 





Res Flags 
rest of Res Name 


Figure 2: Analysis of the hex dump of TEST.RES. 


typedef struct { 
BYTE ff; 
WORD id; 

} 10; 
typedef struct { 
union { 

1D id: 


char name[variable_length] ; 


} type; 
union { 
ID id; 


char name[variable_length] ; 


} name_or_id; 
WORD mem_flags; 


// 1 = RT_CURSOR, 2 = RT_BITMAP, etc. 


// first byte *not* OxFF 


// ordinal number of resource 


// first byte *not* OxFF 


// ®x1@=MOVEABLE, @x20=PURE, @x4Q=PRELOAD, 


// @x1@00=DISCARDABLE 


DWORD size; 
BYTE res_data[size]; 
} RES_FILE_ENTRY:; 


// *not* including this header 
// the resource data: 
// NOT VALID C! 


gee SDK v. 4&, ch. 7 


// RES file is just an accumulation of these entries 
RES_FILE_ENTRY RES_FILE[num_resources] ; 





Figure 3: C pseudocode for .RES file structure. 


C:\DDJ>reslist test.res 


Icon: #1 (744 bytes at ofs cH) 


Group icon: BARFOO (20 bytes at ofs 3@4H) 


Dialog box: FOOBAR (78 bytes at ofs 328H) 

Menu: BARBAR (84 bytes at ofs 386H) 

Accelerator table: FOOFOO (5 bytes at ofs 3eaH) 

Name table (obsolete in 3.1): #1 (58 bytes at ofs 3fbH) 
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sometimes builds a “name table” at the 
end of the file. However, this name table 
is just another resource type (obsolete 
in 3.1), and resources can be included 
in an executable file without it. 

To distinguish Win32 .RES files from 
Win16 .RES files, Microsoft starts off all 
Win32 .RES files with an entry that is il- 
legal in both Win16 and Win32. For our 
purposes, we need only note that the 


To distinguish 
Win32 .RES files 
from Win16 .RES 
files, Microsoft starts 
off all Win32 .RES 
files with an entry 
that is illegal in both 
Win16 and Win32 





first byte is 0: In Win16 terms, the 0 (be- 
cause it is something other than OxFF) 
means that this is a named (rather than 
numeric) type, but the same 0 then 
means that the ASCIIZ name has a zero 
length, which is illegal. This strange 
method (necessary only because .RES 
files have no header) is documented in 
Microsoft’s RESFMT.TXT on the Win32 
CD-ROM. 

The format of a .RES file entry cannot 
be easily wrapped up in the structure of 
a programming language such as C or 
Pascal, because the optional presence 
of an ASCIIZ string gives the resource- 
header format a variable length. How- 
ever, “close-enough” C pseudocode can 
be presented; see Figure 3. A C “union” 
(like a variant record in Pascal) is used 
to indicate that the resource type can be 
either an ASCIIZ string or a 3-byte OxFF- 
prefixed ordinal number. 

RESLIST.CPP (Listing Two, page 153) 
is a short C++ program that walks 
through a .RES file, displaying the type, 
name, size, and file offset of each re- 
source. (The size and offset are for the 
resource itself, not including the head- 
er.) For the 16 predefined resource 
types, RESLIST uses a table of strings in- 
dexed by the resource type. Note that 
RESLIST.CPP does not use the RES_ 
FILE_ENTRY structure from Figure 3; 
this is because that structure is merely 
pseudocode. The variable-length struc- 
ture means that knowledge of how to 
get from one field to another, and from 
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WHEN EVERY 
=) ee CFO 5) a a 


you can count on ImageMan. The 
ImageMan family of products from DTI is 
your best bet if you need to add support 


for the industry standard image formats 


to your Windows application. You'll gain 
instant access to the TIFF, PCX, GIF, 
TARGA, EPSF, BMP, and WMF images 


| that your application needs to become 


truly world class. Each Image- 
Man product is designed to meet 
your needs and exceed your 
expectations, and all -s 
are distributed 

royalty-free and 


image 
backed by our 90-day 


money back guarantee. 


ImageMan - the original, and still the 
best. ImageMan provides a range of 
high-speed functions which allow you to 
scan, display and print all the industry- 


ImageMan/X - the ultimate in image 
export libraries. With ImageMan/X, 
your application can export TIFF, PCX, 
GIF, TARGA, EPS and BMP files with 
unbelievable ease and you have 
complete control over all aspects of file 
creation. 


$3 DSTS99S 


a 7 . 
". ImageMan/VB - the power of 
* im ge JmageMan in an easy to use Visual 


Basic custom control. You can 
scan, display and 
print images with the 
same amazing speed 
of the eriginal 

ImageMan, plus gain built-in support 


for panning, zooming, Fades, Wipes and 


other image manipulation functions. 
$249 


For the very best in imaging tools, call 
‘ dS ¢ 


standard image formats with a simplicity 


DTI today at 1-800-955-8015 


1000 Business Ctr Dr * Ste 120 
Savannah, GA 31405 
(942 j)657-SO03 
Fax: (912)651-8021 
BBS: (9]2)651-SO15 
DATA TECHNIQUES. ING 


that is nothing short of amazing. Plus, 
ImageMan’s advanced architecture 
allows your application to support new 
image formats "on the fly", without 
changing your source code! 

$395, $995 w/source 
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Indexes of 


Dr. Dobb’s Journal 


1982-1992 


¢ Cumulative Subject and Author Indexes covering the 
years 1982 through 1992, bound in ONE volume. 

e An 8"x11" paperback with over 120 pages and 7900 
entries. 

e Detailed coverage of all editorial material, including 
reviews, letters, tables, sidebars, bug reports, 
corrections, etc. 

e Also available on disk in text file, formatted for output 
to Epson-compatible printer. Previous purchasers of 
the disk version may purchase the latest disk edition 
for $10.00 (Canada $10.85 U.S.). 


BOOK: $21.95 ppd DISK: $14.95 ppd 
(Canada $22.85 U.S.) (Canada $15.70 U.S.) 


VISA/MC 


Cu: 804-977-7015 ax: 804-286-4744 


Stephen Bach, 1411 A Short 18th St., Charlottesville, VA 22902-5402 
Specify 5" or 3" when ordering. For shipping paperback via first class mail add $1.75 (Canada $2.00 U.S.). 
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UNDOCUMENTED CORNER 





one .RES file entry to another, has to be 
embedded in the code itself. 

Sample RESLIST output for TEST.RES 
is shown in Figure 4; compare this with 
the original TEST.RC in Figure 1. RES- 
LIST just lists the resources in a .RES 
file, one per line. Details on each 
individual resource are not given, as 
the information necessary to decode 
these is already documented in the 
SDK. For example, upon encountering 
a dialog box (type.id==RT_DIALOG), 
you'd need to get the number of con- 
trols from the DLGHEADER, along with 
the dialog style and dimensions; you 
would then walk through each control, 
using the CTRLHEADER. 

The SDK documentation works here 
because the only significant difference 
between resources in .RES files and 
resources within .EXE files is that each 
resource in the .RES file has one of 
the headers shown in Figure 3, where- 
as the .EXE file has a Resource Table 
(the format of which is documented 
in the SDK; also see Microsoft Systems 
Journal, September 1991). The re- 
source data itself is identical between 
the two formats and is transferred 
from the .RES to the .EXE without 
change. Another difference between 
-RES files and resources in .EXE files 
is that the .RES file is an unordered 
collection of resources, whereas RC 
reorders resources before attaching 
them to an executable file. Resources 
in an .EXE file are ordered by type; 
there is a field in the executable’s Re- 
source Table that tells how many re- 
sources exist of each type. 

There’s another small difference: The 
.RES-file length field is a DWORD, and 


a3 
pane ai 


CATMP\PROG 


Test Menu 





the resource file offset is only implicit; 
the .EXE file, on the other hand, has 
room for both the offset and length of 
the resource, but uses only a WORD to 
store them. As Windows executables 
can be very large, the resource offset 
and length are stored and shifted by 
some amount; this resource shift count 
is stored as the first word in the Re- 
source Table. 


Knowing the 
RES file format 
can help developers 
to load and unload 
resources on the fly 


The information in this article, to- 
gether with the information in the SDK, 
could be used to decompile a .RES file 
back to the original .RC files. The in- 
formation in the SDK alone is sufficient 
to decompile resources in executable 
files back to the original .RC file. 

[Editor's Note: Stan Mitchell of Eclec- 
tic Software has written such a resource 
decompiler. I’ve written a resource 
dumper (the RESDUMP program in- 
cluded with my Windows Source tool, 
distributed by V Communications), but 
mine doesn't produce an .RC file; Stan’s 
is a genuine resource decompiler. Alex 
and Dmitry also have such a tool which 
is available electronically] 








‘ 
mi 


vj) 


1 @Mata f[lapamerpe: Oxno Cnpasxa 





Figure 5: CDI loads resources from .RES files, using the READRES library. 





Here, CDI has loaded a dialog box from PROGMAN.RES, which in turn was 
extracted from the Cyrillic version of Program Manager using a resource- 


decompilation tool. 
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Accessing Resources 

Usually, resources are stored in an ex- 
ecutable file; the Windows kernel pro- 
vides us with a set of API functions to 
load them. But, using the .RES file for- 
mat presented here, it is possible to im- 
plement a set of Windows functions 
which will instead allow you to load 
resources from a .RES file. We’ve cre- 
ated such a set of functions and a test 
program showing how to use them. 
Some Windows API functions already 
exist to load resources “indirectly;” 
these are very helpful when loading 
resources from a .RES file. Where such 
functions do not exist (for BMP, ICO, 
and CUR resources), we created the 
closest equivalent. 

Our library, READRES.CPP and 
READRES.H, is too large to include 
here, but it is available electronically, 
as is the test program, CDI; see Figure 
5. (Note that CDI is examining the .RES 
file for the Cyrillic version of Program 
Manager; this .RES file was extracted 
from PROGMAN.EXE using our re- 
source decompiler.) 

First, we need to implement a func- 
tion which will load a particular resource 


from a .RES file. As seen in Listing Three - 


(page 153), LoadRESResource() walks 
through a .RES file, just like RESLIST.CPP. 
However, instead of printing out infor- 
mation on each resource, it searches for 
the resource whose type and name the 
caller specifies. If the requested resource 
is found, LoadRESResource() calls Glob- 
alAlloc( to allocate sufficient memory 
for it (the amount of memory comes 
from the DWORD size found in the 
.RES-file entry header), GlobalLocks the 
memory, and then reads in the resource 
data. It returns to the caller with a han- 
dle to the raw resource data. 

Okay, here we are with a request- 
ed resource loaded in some portion 
of memory referenced through a glob- 
al memory handle. What to do next? 
This depends on the type of resource 
we've loaded. Some resource types 
are easy to use from a .RES file, be- 
cause Windows already provides “in- 
direct” functions. For example, take a 
look at LoadRESMenu() in Listing Four 
(page 153), which uses LoadMenu- 
IndirectO. 

Loading dialog boxes from a .RES file 
is also fairly easy, except that any pro- 
gram that calls CreateRESDialog() must 
supply an additional parameter: the ad- 
dress of a dialog proc. All other work 
is done through CreateDialogIndirect- 
Param. Supplying a generic dialog 
proc for someone else’s dialog box can 
be quite difficult. Your dialog proc must 
handle at least one message, WM_INIT- 
DIALOG. 

Loading other resource types (such 
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as bitmaps, cursors, icons, and acceler- 
ators) from a .RES file is trickier, the 
code itself may be found in READ- 
RES.CPP (available electronically). 

As noted in the “Introduction,” _know- 
ledge of resource formats can be ap- 
plied to Windows environments based 
on interpreting languages. You could 
also apply this knowledge to security: 
You could scramble your resources with 
a password or simply XOR them and 
add some unscrambling features into a 
FindResource “engine.” Another inter- 
esting use might be resource packing: 
You could implement your own re- 
source loading (borrowing from the 


code in READRES.CPP) and include 
some unpacking features in it. For ex- 
ample, you can store packed bitmaps 
to reduce the total size of your appli- 
cation. You don’t need to use user-de- 
fined RCData resources for that. 


DDJ 
(Listings begin on page 153.) 
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Roaming the Internet, 
Part 3 


p until a year ago, I was only 

vaguely aware of the Internet’s 

existence. In fact, my only ex- 

posure to the Internet was those 
funny electronic-mail addresses on some 
peoples’ business cards: mickey@dis- 
ney.com and so on. Then by a strange 
quirk of fate, I became involved in a 
project with some genetics researchers 
at my hospital, and found that nearly 
all of the databases they needed access 
to were available only via the Internet. 
For better or worse, at just about the 
same time, the trade-book publishers 
were also discovering the Internet as a 
new market niche, so I had no dearth 
of reading material. And fortunately for 
me, some of the books actually turned 
out to be helpful! 

Becoming acquainted with the Inter- 
net is like falling through a manhole and 
discovering a city of aliens with their own 
markets, libraries, and culture, living out 
an unsuspected parallel existence only a 
few feet away. This new world has its 
own code of conduct, its own heroes and 
villains, its own pantheon of gods and 
sacred cows, and its own collection of 
legends and myths. The players, the play- 
ing field, and for that matter the rules of 
the game are totally unfamiliar, even al- 
lowing for some previous experience with 
stand-alone UNIX systems or commercial 
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online services such as CompuServe. To 
me, after having floundered my way up 
the learning curve over the last year, there 
are three particularly amazing aspects of 
the Internet: 


e The TCP/IP, e-mail, and other fun- 


damental Internet protocols, although 
adopted in a fairly ad hoc manner a 
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cue ago, continue to son was even 
though the number of hosts on the net 
has been scaled up by at least three or- 
ders of magnitude. 

e The government and the primary 
network users pour money into the net- 
work backbone and increase its capac- 
ity year after year, but no attempt is 
made to make individual hosts liable for 
the traffic generated by their users. (For 
that matter, no one is exactly sure how 
many hosts are on the net, let alone 
how many users.) 

e Many Internet users are totally obliv- 
ious to the incredible technology and 
infrastructure they are exploiting, and 
squander network bandwidth with 
pointless flame wars, trivial appeals for 
help, thinly disguised attempts to cheat 
on take-home exams, and download- 
ing of semi-useless shareware utilities 
from archive servers all over the globe. 


Those of you who don’t work in a 
large corporation or educational insti- 
tution will probably have your first en- 





counters oui the Internet via ar -up 


to a so-called “public provider.” This 
gives you access to world-wide elec- 
tronic mail and USENET news, but the 
low bandwidths of a modem connec- 
tion essentially make you a second-class 
citizen on the net. To reap the full ben- 
efits of the archive sites and tools such 
as gopher and WAIS, you really need to 
be hardwired to the network. Making 
this happen is no trivial chore, and a 
job I recommend you leave to the ex- 
perts. Nevertheless, I wanted to wind 
up this series of book reviews about 
the Internet (see also the December 
1992 and February 1993 issues of DD/J) 
by mentioning a few books that will 
help you decipher the many layers of 
network arcana and (eventually) be- 
come somewhat self-sufficient. In ad- 
dition, I’ve included a list of other In- 
ternet-related books, some previously 

reviewed. 
DNS and Bind, by Paul Albitz and 
Cricket Liu, and TCP/IP Network Ad- 
(continued on page 146) 
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(continued from page 143) 

ministration, by Craig Hunt, are mem- 
bers of the “Nutshell Handbook” series 
from O’Reilly and Associates. Although 


there is some degree of overlap between . 


the two books, I strongly recommend 
that you get both; the differing per- 
spectives and emphasis of the authors 
can be quite helpful when trying to de- 
bug TCP/IP or mail problems. TCP/IP 
Network Administration starts with ba- 
sic TCP/IP protocol concepts, moves on 


to routing, domain name services, and 
sendmail configuration, and finishes up 
with chapters on troubleshooting and 
security. DNS and Bind, as you would 
expect from the title, focuses much more 
intensely on setting up and maintaining 
domain name servers and resolvers. 
Both books, like all the other O'Reilly 
books I’ve been exposed to, demon- 
strate careful writing, tasteful editing, 
and painstaking production. They’re a 
pleasure to own and use. 


The Internet Message, by Marshall T. 
Rose, is billed as “The Exciting Fourth 
Book in MTR’s Networking Trilogy.” 
Rose is well known for his work on the 
Internet mail system and OSI directory 
services over the last decade, and more 
recently has been influential in the de- 
velopment of multimedia-mail proto- 
cols. The Internet Message is basically 
an explanation of how the Internet 
name services, mail protocols, mail- 
transport agents, and mail-user agents 
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You'll get all the features of a full-function PL/I 
compiler/library combined with the many 
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for just $495! 
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work and interact, with a great deal of 
Rose’s personal humor, philosophy, and 
editorialization thrown in at no extra 
charge. For example: 


There are still people in the world who 
think OSI is going to happen. I suppose 
there are also people in the world who 
think that the moon is made of cheese. 
However, I wouldn’t necessarily trust the 
judgement of either kind of optimist. 


Although Rose has little patience with 
the ponderous, poorly thought-out OSI 
standards and implementations, he’s also 
ecumenical. The notorious weak points 
of the UNIX-based Internet tools come 
in for their share of criticism: 


Perhaps the most commonly used im- 
plementation of a mail transfer agent in 
the Internet is sendmail. It is a tribute to 
the Internet mail system that it works so 
well given that sendmail behaves so poor- 
ly.... Clearly, sendmail is an excellent ex- 
ample of how to do a lot of things wrong. 
But, since sendmail is shipped with 
Berkeley UNIX, most sites just put up with 
it.... People just stumble along with a 
canned sendmail configuration, poking 
at it from time to time if problems arise. 


After spending more than a few 
hours puzzling over sendmail config- 
uration files, I was relieved to find out 
that I wasn’t the only person who con- 
sidered it brain-damaged. You needn't 
trouble yourself to read The Internet 
Message if you’re content to use your 
system’s mail programs blindly. How- 
ever, if you are considering writing 
your own mail or news client, or even 
if you are just curious about the un- 
derlying mechanisms of electronic 
mail, The Internet Message is an ex- 
cellent place to start. 

The Internet System Handbook, edit- 
ed by Daniel Lynch and Marshall Rose, 
is not so much a book as a hardbound 
collection of technical essays by diverse 
networking computer scientists, gurus, 
and engineers. There’s a lot of valuable 
information in this book, but you have 
to mine it for what you need; the book 
is only loosely organized, and there is 
a significant amount of overlap and re- 
dundancy. The book is also uneven in 
both style and technical level and suf- 
fers from an obvious lack of copy edit- 
ing; some articles are stilted and opaque, 
while others are refreshingly direct and 
practical. One can only regret that, pre- 
sented with such a unique collection of 
raw material, the publisher didn’t invest 
a littlke more effort in processing that 
material into a structured, coherent, ap- 
proachable whole. Nevertheless, this 
book should be on the shelf of every 
serious network programmer and ad- 
ministrator. 
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End-user books: 7/e Whole Internet 
User’s Guide and Catalog, by Ed Krol 
(O'Reilly & Associates, 1992, ISBN 0- 
56592-025-2, $24.95). An excellent mid- 
level introduction to the Internet. How 
to connect, why to connect, how to use 
basic network tools, and how to trou- 
bleshoot networking problems. Highly 
recommended; by far the best of all the 
end-user Internet books. 

Internet: Getting Started, April Ma- 
rine, Susan Kirkpatrick, Vivian Neou, 
and Carol Ward, editors (Prentice Hall, 
1993, ISBN 0-13-327933-2, $28.00). A 
lot of useful reference material: in- 
dex to RFCs, list of public providers, 
overseas contact information, and so 
on. Not primarily a “how-to” book, 
so it makes a good companion to the 
Krol book. 

Zen and the Art of the Internet: A 
Beginner’s Guide, second edition, by 
Brendan P. Kehoe (Prentice Hall, 1993, 
ISBN 0-13-010778-6, $22.00). Brief guide 
to Internet utilities and resources from 
a typical UNIX viewpoint. In spite of 
the title, definitely not for the average 
PC user. A bit too technoid and smug 
for my taste, and the editing and pro- 
duction values are dismal. 

The Internet Companion: A Begin- 
ner’s Guide to Global Networking, by 
Tracy LaQuey and Jeanne C. Ryer 
(Addison-Wesley, 1993, ISBN 0-201- 
62224-6, $10.95). Apparently directed 
at the technologically illiterate—could 
have been titled Bill and Ted’s Excel- 
lent Network Adventure. 

Internet: Mailing Lists, Edward T.L. 
Hardie and Vivian Neou, editors (Pren- 
tice Hall, 1992, ISBN 0-13-327941-3, 
$39.00). Comprehensive guide to mail- 
ing lists, many of which are reflected to 
USENET (or vice versa). Especially valu- 
able for Internet users who have dial- 
up e-mail access only, or for Bitnet users. 

Using UUCP and UseNet, by Grace 
Todino and Dale Dougherty (O'Reilly & 
Associates, 1986, ISBN 0-937175-10-2, 
$21.95). UNIX-centric, but instructions 
on the use and abuse of Internet “news” 
will be helpful to all. 

Network administration: DNS and 
BIND, by Paul Albitz and Cricket Liu 
(O’Reilly & Associates, 1992, ISBN 
1-56592-010-4, $29.95). Very helpful ex- 
planations of DNS, bind, sendmail con- 
figuration, and so on. Coverage of Sun 
OS peculiarities is sometimes spotty. 

TCP/IP Network Administration, by 
Craig Hunt (O’Reilly & Associates, 1992. 
ISBN 0-937175-82-X. $29.95). Clearly 
written, extremely helpful overview of 
TCP/IP from protocol basics to config- 
uration of gateways, DNS, and send- 
mail. Also includes nice discussions of 
network troubleshooting and security 
considerations. 





Internetworking: A Guide to Network 
Communications, by Mark A. Miller 
(M&T Books, 1991, ISBN 1-55851-143-1, 
$34.95). A somewhat abstract overview 
of internetworking and protocols, both 
LAN and WAN. 

Practical UNIX Security, by Simson 
Garfinkel and Gene Spafford (O'Reilly 
& Associates, 1991, ISBN 0-937175-72-2, 
$29.95). UNIX-centric, but includes dis- 
cussions of passwords, gateways, fire- 
wall machines, and the like that will be 
valuable to any system administrator. 

Managing UUCP and UseNet, tenth 
edition, by Tim O'Reilly and Grace Todi- 
no (O’Reilly & Associates, 1992, ISBN 
0-937175-93-5, $27.95). General discus- 
sion of e-mail and news servers and 
clients. 

!%@:: A Directory of Electronic Mail 
Addressing and Networks, by Donnalyn 
Frey and Rick Williams (O’Reilly & As- 
sociates, 1990, ISBN 0-937175-15-3, 
$27.95). A coffee-table book for Inter- 
net nerds. 

Networking technology: 7CP/IP: 
Architecture, Protocols, and Implemen- 
tation, by Sidnie Feit (McGraw-Hill, 
1993, ISBN 0-07-020346-6, $45.00). Text- 
book approach: thorough but not very 
friendly. 

The Simple Book: An Introduction to 
Management of TCP/IP-based Internets, 
by Marshall T. Rose (Prentice Hall, 
1991, ISBN 0-13-812611-9, $54.00). A 
nice explanation of SNMP by one of 
its inventors. 

The Internet Message: Closing the 
Book with Electronic Mail, by Marshall 
T. Rose (Prentice Hall, 1993, ISBN 
0-13-092941-7, $44.00). Overview of In- 
ternet mail protocols by one of the 
most famous Internet gurus. 

Internet System Handbook, Daniel C. 
Lynch and Marshall T. Rose, editors (Ad- 
dison-Wesley 1993, ISBN 0-201-56741-5, 
$59.25). A massive collection of techni- 
cal essays and overviews, of varying lev- 
els of usefulness. 

Stacks: Interoperabilitiy in Today’s Com- 
puter Networks, by Carl Malamud (Pren- 
tice Hall, 1992, ISBN 0-13-484080-1, 
$35.00). A succinct overview of com- 
peting network protocols and transports: 
OSI, TCP/IP, ISDN, X.25, and the like. 

Exploring the Internet: A Technical 
Travelogue, by Carl Malamud (Prentice 
Hall, 1992, ISBN 0-13-296898-3, $26.95). 
This book defies classification. The au- 
thor recounts his jaunts around the 
world to meet Internet wizards and taste 
exotic foods. 
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Listing One (Text begins on page 123.) 


#include <stdio.h> 
#include <dos.h> 
#include <stdlib.h> 


int ports[] = { 


0x378, 
0x379, 
0x37a, 
@x3bec, 
@x3bd, 
@x3be 
Le 
void main(int argc, char *argv[]) 
{ 
int i; 
for (i = @; i < 6; i++) 
printf("%04x ", ports[i]); 
putchar('\n'); 
while (1) { 
putchar('\r'); 
for (i = @; i < 6; i++) { 
if (arge > 1) 
outportb(ports[i], atoi(argv[1])); 
printf("%04x ", inportb(ports[i])); 
} 
} 
} 
e e 
Listing Two 


#include <stdio.h> 
#include <bios.h> 


void main() 


{ 
int c = Q; 
while ((c & 255) != 27) { 
c = bioskey(@) ; 
printf ("\n%@4x", c); 
} 
Listing Three 


#include <dos.h> 
#include <stdio.h> 


[| ==sse<== typematic values 
#define DELAY 10 
#define TYPEMATIC 1 
[* ------- the interrupt function registers -------- */ 
typedef struct { 
int bp,di,si,ds,es,dx,cx,bx,ax,ip,cs,fl; 
} IREGS; 
// ---- map signals to keystrokes 
struct pmap { 
int KeyCode; 


int Port; 
int bit; 
int mask; 
int prime; 
Ve 
int’ keycount; // number of keys simulated 


#define MAXKEYS 20 // maximum keys to simulate 
struct pmap PTb1[MAXKEYS]; // table of simulated keys 
|[[ ---------- interrupt vectors 

#define KEYBOARD 0x16 

#define TIMER Oxic 

#define ZEROFLAG @x4@ 

|| ----=--- @x16 BIOS functions 

#define READKEY @ 

#define KEYSTATUS 1 

|| ------ interrupt vectors 

static void (interrupt *oldtimer) (void); 

static void (interrupt *old16) (void); 

static void interrupt newtimer (void) ; 

static void interrupt int16(IREGS) ; 

|] <necac= TSR stuff 

static unsigned highmemory; 

static unsigned sizeprogram; 

extern unsigned _heaplen = 1; 

extern unsigned _stklen = 1024; 


void main() 
{ 
int 4; 
// ---- read in the number of keys to simulate 
scanf("%d", &keycount) ; 
if (keycount <= MAXKEYS) { 
// ---- read the key simulation table 
for (i = 0; i < keycount; i++) 
scanf ("%X %X %X %X %X", 
&PTb1 [i] .KeyCode, 
&PTb1[i] .Port, 
&PTb1[i] .bit, 
&PTb1 [i] .mask, 
&PTb1 [i] . prime) ; 
/* ----- attach interrupt vectors ------ */ 
old16 = getvect (KEYBOARD) ; 
oldtimer = getvect (TIMER) ; 
setvect (KEYBOARD, int16) ; 

' setvect (TIMER, newtimer) ; 

. [* ------ compute program size ------- */ 
highmemory = _SS + ((_SP+8) / 16); 
sizeprogram = highmemory - _psp + 1; 

/* ----- terminate and stay resident ------- */ 
keep(®, sizeprogram) ; 
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} 


C PROGRAMMING 


} 


static int Timer = @; 


aan timer interrupt service routine ------- */ 


static void interrupt newtimer (void) 


{ 
if (Timer > @) 
--Timer; 
(*oldtimer) (); 
} 
// ---- test for simulated key pushed 
static int pushbutton (void) 
{ 
int i, b, key = 9; 
static int TimerValue = DELAY; 
if (Timer == @) { 
for (i = 0; i < MAXKEYS; it+t) { 
struct pmap pm = PTbl[i]; 
outportb(pm.Port, pm.prime) ; 
b = inportb(pm. Port) ; 
if ((b & pm.bit) == pm.mask) { 
Timer = TimerValue; 
TimerValue = TYPEMATIC; 
key = pm.KeyCode; 
break; 
} 
} 
if (i == 5) { 
Timer = Q; 
TimerValue = DELAY; 
} 
} 
return key; 
} 
/* ----- Keyboard BIOS ISR ------- +/ 
static void interrupt .int16(IREGS ir) 
i 
int func = (ir.ax >> 8) & Oxff; 
static int newkey = 9; 
static int rdflags = @; 
static int stflags = 9; 
/* -- for read key bios call, loop until key pressed -- */ 
if (func == READKEY) { 
int flg = ZEROFLAG; 
while (flg & ZEROFLAG) { 
_AH = KEYSTATUS; 
geninterrupt (KEYBOARD); /* this will call myself */ 
flg = _FLAGS;: 
} 
} 
if (func == READKEY |; func .== KEYSTATUS) { 
if (!newkey) 
newkey = pushbutton() ; 
if (newkey) { 
ir.ax = newkey; 
if (func == READKEY) { 
newkey = @; 
ir.fl = rdflags; 
} 
else 
ir.fl = stflags & ~ZEROFLAG; 
return; 
} 
} 
_BX = ir.bx; 
_CX = ir.cx; 
_AX = ir.ax; 
(*01d16) (); 
ir.ax = _AX; 
ir.fl = _FLAGS; 
if (func == READKEY) 
rdflags = ir.fl; 
if (func == KEYSTATUS) 
stflags = ir.fl; 
} 


End Listings 
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Listing One (Text begins on page 129.) 


const 
ESCAPE = @; 
ENDOFLINE = @; 
ENDOFBITMAP = 1; 
DELTA = 2; 
procedure UnpackRLE8(var f: FILE); 
var 
done: Boolean; 
count: Integer; 
oldCount: Integer; 
byt: Byte; 
begin 
while ((not done) and 
(not eof(f))) do 
begin 
byt := GetByte(f) ; 
if (byt = ESCAPE) then 
begin { Unpack escape code } 
byt := GetByte(f) ; 
case byt of 
ENDOFLINE: 
StartNewScanLine; 


ENDOFBITMAP: 
done := True; 
DELTA: 
begin { Not implemented } 
Writeln('Delta escape!'); 
Halt 
end; 
else begin 
{ Absolute-mode run } 
count := byt; 


oldCount := count; 
while count > @ do 
begin 
byt := GetByte(f); 
PutByte (byt) ; 
count := count - 1 
end; 


if Odd(oldCount) { padding } 
then byt := GetByte(f) 
end { else } 
end { case } 
end else 
begin { Unpack RLE unit } 
count := byt; 
byt := GetByte(f); 
while count > @ do 
begin 
PutByte(byt) ; 
count := count - 1 
end { while } 
end { else } 
end { while } 
end; { UnpackRLE8 } 


e e 
Listing Two 
const 
READING = @; 
ENCODING = 1; 
ABSMODE = 2; 
SINGLE = 3; 


ENDOFLINE = 4; 
NOSTATE = 999; 
procedure PackRLE8 ( 
np: Integer; sl: ScanLine) ; 
var 
slx: Integer; 
state: Integer; 
pixel: Integer; 
count: Integer; 
done: Boolean; 
oldcount: Integer; 
oldslx: Integer; 


begin 
slx := @; { Scan line index } 
state := READING; 
done := False; 


while not done do begin 
case state of 
READING: 
(* Input: 
np = # pixels in scan line 
sl = scan line 
sl{slx] = next pixel *) 
begin 
if slx >= np then 
state := ENDOFLINE 
else if slx = np - 1 then 


begin 
count := 1; { 1 pixel left } 
state := SINGLE 

end else 


if sl(slx] = sl[slx + 1] then 
state := ENCODING 
else 
state : 
end; 
ENCODING: 
(* Input: 
slx <= np - 2 (Run of 2+ pixels) 
sl[slx] = first pixel of run 
sl[slx] = sl[slx + 1] *) 
begin 


ABSMODE 
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count := 2; 
pixel := sl{slx]; 
slx := slx + 2; 


while ((slx < np) and 
(pixel = sl[slx]) and 
(count < 255)) do 


begin 
count := count + 1; 
slx := slx + 1 
end; 
PutByte(count); { RLE unit } 
PutByte (pixel) ; 
state := READING 
end; 
ABSMODE: 
(* Input: 


slx <= np - 2 (Run of 2+ pixels) 
sl{slx] = first pixel of run 
sl[slx] <> sl[slx + 1] *) 


begin 
oldslx := slx; { Save index } 
count := 2; 
slx := slx + 2; 


{ Compute # bytes in run } 
while ((slx < np) and 
(sl{slx] <> sl[slx - 1]) and 
(count < 255)) do 


begin 
count := count + 1; 
slx := slx + 1 

end; 


{ Back up on same-color run } 
if ((slx < np) and 
(sl[slx] = sl[slx - 1])) 
then if (count > 1) 
then count := count - 1; 
slx := oldslx; 
if (count < 3 ) then 
state := SINGLE {short run} 
else begin {normal run} 
PutByte(Q) ; 
PutByte (count) ; 
oldcount := count; 
while (count > @) do 
begin 
PutByte(sl[slx]) ; 
slx := slx + 1; 
count := count - 1 
end; 
if Odd(oldcount) then 
PutByte(®); {word padding} 
state := READING 
end { else } 
end; 
SINGLE: 
(* Input: 
count = # pixels to output 
slx < np 
sl{slx] = first pixel of run 
sl[slx] <> sl[slx + 1] *) 


begin 
while count > @ do 
begin 
PutByte(@1) ; 
PutByte(sl[slx]); 
slx := slx + 1; 
count := count - i 
end; 
state := READING 
end; 
ENDOFLINE: 
begin 
PutByte(@) ; 
PutByte (Q) ; 
done := TRUE; 
state := NOSTATE 
end; 
else 
begin 
Writeln('Unknown state'); 
Halt 
end 


end { case state of } 
end { while } 
end; { PackRLE8 } 
begin 
Read (np) ; 
Read (ns) ; 
while (ns > @) do 
begin 
GetNextScanLine(s1); 
PackRLE8(np, sl); 
ns :=ns - 1 
end; 
PutByte(@); { Mark bitmap end } 
PutByte(1) 
end. 


Listing Three 
/* ----------------------------------------------------------- *\ 


KK o2------------------- +--+ +--+ +--+ +--+ *x 
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#include <iostream.h> 
#include <iomanip.h> 
#include <fstream.h> 
#include <stdlib.h> 


typedef unsigned char Byte; 


#define FALSE @ 
#define TRUE 1 


// Compression escape codes 
#define ESCAPE @ 

#define ENDOFLINE @ 

#define ENDOFBITMAP 1 
#define DELTA 2 


void Error(const char *msg) ; 

void DecompressFile(const char *fname) ; 
int Odd(int v); 

int GetByte(ifstream &ifs) ; 

void PutByte(unsigned char b); 


int main(int argc, char *argv[]) 
{ 
if (arge <= 1) 
Error("filename missing") ; 
DecompressFile(argv[1]); 
return @; 


// Display error message and halt 

void Error(const char *msg) 

{ 
cerr << endl << "Error: " << msg << endl; 
exit (1); 

} 

// Decompress fake bitmap file fname. Write decompressed results to stdout 

void DecompressFile(const char *fname) 

{ 
int endOfBitmap; // True if @@ 01 found at end of input 
int count; // Used at various locations in function 
int oldCount; // Copy of count for absolute-mode units 
unsigned byte; // Input bytes 


ifstream ifs(fname, ios::in); 
if (!ifs) 
Error("unable to open file"); 
endOfBitmap = FALSE; 
while (!endOfBitmap && !ifs.eof()) { 
byte = GetByte(ifs) ; 
if (byte == ESCAPE) { 
// Unpack escape code unit 
byte = GetByte(ifs) ; 
switch (byte) { 
case ENDOFLINE: 
cout << endl; 
break; 
case ENDOFBITMAP: 
endOfBitmap = TRUE; 
cout << endl; 
break; 
case DELTA: 
Error("Delta escape codes not implemented") ; 
break; 
default: // Absolute-mode run 
count = byte; 
oldCount = count; 
while (count > 0) { 
byte = GetByte(ifs) ; 
PutByte (byte) ; 
count--; 


} 
if (Odd(oldCount) ) 
byte = GetByte(ifs); // Read word-boundary padding byte 
break; 
} 
} else { 
// Unpack run-length-encoded unit 
count = byte; 
byte = GetByte(ifs) ; 
while (count > @) { 
PutByte (byte) ; 
count--; 
} 
} 


} 
if (!endOfBitmap) 
Error("End of bitmap marker (@@ @1) not found"); 

} 
// Return next byte from input file ifs. Count number of bytes read 
int GetByte(ifstream &ifs) 
{ 

int b; 

ifs >> hex >> b; 

return b; 
} 
// Return true if v is odd 
int Odd(int v) 
{ 


} 

// Write byte b in hex in 2 columns with leading @ 
// plus one blank to cout 

void PutByte(unsigned char b) 

{ 


return v & @x@1; 


cout << setiosflags(ios::uppercase) ; 

cout << setw(2) << setfill('@') << hex << (int)b << '' '; 
cout << setfill(' ') << dec; 

cout << resetiosflags(ios::uppercase) ; 
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Listing Four 


[/* --------------------- nn enn nn nnn nnne *\ 
** tpack.cpp -- Test packing uncompressed bitmap data eK 
kk ----------------------------------------------------------- x 
** Data file format (in ASCII hex): * 
** np ns # pixels per line; # scan lines x 
** pp pp Ppp pp pp... pp pixel byte values in hex 7k 
** PP PP PP PP PP --+ PP : i : “ 
** Pp PP PP PP PP --- PP ‘ : [ o 
Kk ----------------------------------------------------------- ** 
la Copyright (c) 1993 by Tom Swan. All rights reserved. * 
\K ---n-- nn nnn nn nn nen nnn nnn nn nnn nnn nnn nnn nnn nnn nne */ 


#include <iostream.h> 
#include <iomanip.h> 
#include <fstream.h> 
#include <stdlib.h> 


typedef unsigned char Byte; 


#define FALSE @ 
#define TRUE 1 


// State-machine definitions 

#define READING @ // General reading mode 

#define ENCODING 1 // Encoding same-color pixel runs 
#define ABSMODE 2 // Encoding different-color pixel runs 
#define SINGLE 3 // Encoding short absolute-mode runs 
#define ENDOFLINE 4 // End of scan line detected 


void Error(const char *msg) ; 

void CompressFile(const char *fname) ; 

int Odd(int v); 

Byte *NextScanLine(ifstream &ifs, int np); 
void PutByte(Byte b); 

void PackRLE8(int np, const Byte *sl); 


int main(int argc, char *argv[]) 
{ 
if (arge <= 1) 
Error("filename missing") ; 
CompressFile(argv[1]); 
return @; 


// Display error message and halt 
void Error(const char *msg) 
t 
cerr << endl << "Error: " << msg << endl; 
exit (1); 
} 
// Compress test bitmap file fname. Write compressed results to stdout 
void CompressFile(const char *fname) 
{ 
int np, ns; // Number of pixels per line, number of scan lines 
Byte *sl; // Pointer to scan line 


ifstream ifs(fname, ios::in); 
if (life) 
Error("unable to open file"); 
ifs >> hex >> np >> ns; 
if ((np <= @) |; (ns <= 0)) 
Error("bad file format") ; 
while (ns-- > 0) { 
sl = NextScanLine(ifs, np); 
PackRLE8(np, sl); 
delete sl; 
} 
PutByte(@); // Mark end of bitmap 
PutByte(1); 
cout << endl; 
} 


// Return true if v is odd 
int Odd(int v) 
{ 


return v & @x@1; 


// Read next scan line of np pixels from file ifs 
Byte *NextScanLine(ifstream &ifs, int np) 
. 
if (np <= @) Error("np zero or less in NextScanLine()"); 
Byte *sl = new Byte[np]; // Allocate scan line 
if (!sl) Error("out of memory") ; 
int j = 9; 
int k; 
while (np-- > @) { 
ifs >> hex >> k; 
sl [j++] = k; 


return sl; 
} 
// Write byte b in hex in 2 columns with leading @ plus one blank to cout 
void PutByte(Byte b) 
{ 


cout << setiosflags (ios: : uppercase) ; 
cout << setw(2) << setfill('@') << hex << (int)b << ' '; 
cout << setfill(' ') << dec; 
cout << resetiosflags(ios::uppercase) ; 
} 
// Compress np pixels in sl. Write compressed line to stdout 
void PackRLE8(int np, const Byte *s1l) 


// Scan line index 

// State machine control variable 
int pixel, count; // Used by various states 

int done = FALSE; // Ends while loop when true 

int oldcount, oldslx; // Copies of count and slx 


int slx = @; 
int state = READING; 


(continued on page 152) 
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TLIB Version Control 
For DOS, OS/2 and Windows-NT 


e The experts loved TLIB 4: 


“amazingly fast... TLIB is a great system.” PC Tech Journal 


“TLIB has features and power to spare... TLIB is easy to use and 
the fastest of the reviewed packages.” Computer Language 


“T will not program without it.” Uptime Magazine 













e Now TLIB 5.0 adds: 


Automatic branching. Automatic version labeling across branches. 
User defined promote structures, for staged development. Exclusive 
whole-level change migration for customized software. N-way-tree 
version numbers. Branch and full locking. OS/2 & NT support. 










e Plus the features they loved in TLIB 4: 


Check-in/out locking. Branching, for parallel development. Keywords. 
Full binary file support (does not depend upon CRs in the file like other 
products). Wildcard and list-of-file support; can create lists by scanning 
source code for includes. Can merge (reconcile) multiple simultaneous 
changes and undo intermediate revisions. Network and WORM optical 
disk support. Mainframe-compatible delta generator for Pansophic, 
ADR, IBM, Sperry formats. Includes integrated PD MAKE by L. Dyer; 
also integrates with Opus™ MAKE, Slick™ MAKE, others. 












MS-DOS $139, OS/2 & NT (with MS-DOS) $195 + shipping. 
5 station network: MS-DOS $419, OS/2 $595. Call for other sizes. 
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PO Box 4156, Cary, NC 27519 (919) 233-8128 
FAX: 233-0716 
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C/C++ Programming made easy... 
only from Sams Publishing’ 


cae eile 
g Micon) 2 
The Waite Group 5 


New 


“'C Primer ne 


The Waite Group’s 
New C Primer Plus, 
2nd Edition 


0-672-30319-1, $29.95 USA 


Mastering Borland C++ 
0-672-30274-8, $39.95 USA 


Also Available! 


Tom Swan’s Code Secrets 
0-672-30287-X, $39.95 USA 


Moving from C to C++ 
0-672-30080-X, $29.95 USA 


Turbo C++ Programming 
101 


0-672-30280-2, $29.95 USA 


SAMS 


PUBLISHING 


Available at: 
Barnes & Noble 


Booksellers Since 1873 


TX BOOKSTAR BOOKSTOP 
Dhe Complete Discount Booka The Complore Dixcetint Borkstoa, 
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ALGORITHM ALLEY 


Listing Four (Zisting continued, text begins on page 129.) 


while (!done) { 
switch (state) { 
case READING: 
// Input: 
// np == number of pixels in scan line 
// sl == scan line 
// si{slx] == next pixel to process 
if (slx > np) Error("READING in PackRLE8()"); 
if (slx >= np) // No pixels left 
state = ENDOFLINE; 
else if (slx == np - 1) { 
count = 1; 
state = SINGLE; 
} else if (sl[slx] == sl[slx + 1]) 
state = ENCODING; 
else // Next 2 pixels differ 
state = ABSMODE; 
break; 
case ENCODING: 
// Input: 
// six <= np - 2 (at least 2 pixels in run) 
// si{slx] == first pixel of run 
// si{six] == sl[slx + 1] 
count = 2; 
pixel = sl[slx]; 
slx += 2; 
while ((slx < np) && (pixel == sl[slx]) && (count < 255)) { 
countt+; 
slxtt; 
} 
PutByte(count) ; 
PutByte (pixel) ; 
state = READING; 
break; 
case ABSMODE: 
// Input: 
// six <= np - 2 (at least 2 pixels in run) 
// si({slx] == first pixel of run 
// sl{slx] != sl[slx + 1] 
oldslx = slx; 
count = 2; 
slx += 2; 
// Compute number of bytes in run 
while ((slx < np) && (sl[slx] != sl[slx - 1]) && (count < 255)) { 
count++; 
slxtt+; 


// One pixel left 


// Next 2 pixels equal 


// Output run-length-encoded unit 


} 
// If same-color run found, back up one byte 
if ((slx < np) && (sl[slx] == sl[slx - 1])) 
if (count > 1) count--; 
slx = oldslx; // Restore scan-line index 
// Output short absolute runs of less than 3 pixels 
if (count < 3 ) 
state = SINGLE; 
else { 
// Output absolute-mode run 
PutByte(@) ; 
PutByte (count) ; 
oldcount = count; 
while (count > @) { 
PutByte(sl[slx]) ; 
slxtt+; 
count-~; 


} 
if (Odd(oldcount) ) 
PutByte(@); // End run on word boundary 
state = READING; 
} 
break; 
case SINGLE: 
// Input: 
// count == number of pixels to output 
// slx < np 
// si[slx] == first pixel of run 
// sl[slx] != sl[slx + 1] 
while (count > @) { 
PutByte(Q@1) ; 
PutByte(sl[slx]); 
slxt+: 
count-~—; 
} 
state = READING; 
break; 
case ENDOFLINE: 
PutByte(Q@) ; 
PutByte(@) ; 
done = TRUE; 
break; 
default: 
Error("unknown state in PackRLE8()"); 
break; 


End Listings 
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UNDOCUMENTED CORNER 


Listing One (Text begins on page 133) 


// TEST.RC -- simple input file 
// rc -r test.rc, then dump test.res (see Figure 1) 
#include <windows.h> 


BARFOO ICON some.ico 

FOOBAR DIALOG 10,20,30,40 

CAPTION "FOOBAR" 

CLASS "FOOBAR" 

STYLE WS_BORDER | WS_CAPTION { 
CTEXT "This is a test", -1, 1, 2, 3,.4 
DEFPUSHBUTTON "OK", IDOK, 5, 6, 7, 8 
J 

BARBAR MENU { 

POPUP "&Test” { 
MENUITEM "Cmd &1", 1@1 
MENUITEM "Cmd &2", 102 
7 

POPUP "&Another test" { 
MENUITEM "Cmd &11", 111 
MENUITEM "Cmd &12", 112 
} 

MENUITEM "&Help", 200 

} 

FOOFOO ACCELERATORS { 
VK_F1, 200, VIRTKEY 
} 


Listing Two 


// RESLIST.CPP -- Reads Windows .RES files from "Undocumented Corner," DDJ, 
// August 1993 -- Alex G. Fedorov and Dmitry M. Rogatkin 
// alex@computerpress.msk.su & datasc@adonis@ias.msk.su 


#include <iostream.h> 
#include <fentl.h> 
#include <io.h> 
#include <stdlib.h> 
#include <string.h> 


#define LastResNum 16 


char *StandardResName[] = { 
/* 1 */ "Cursor", 


/* 2 */ "Bitmap", 

/* 3 */ "Icon", 

/* 4 */ "Menu", 

/* 5 */ "Dialog box", 

/* 6 ¥*/ "String table", 
/* 7 */ "Font directory", 
/* 8 */ "Font", 


/* 9 */ "Accelerator table", 

/* 10 */ "RCData (user-defined)", 

/* 11 */ "Not alowed", 

/* 12 ¥*/ "Group cursor", 

/* 13 */ "Not alowed", 

/* 14 */ "Group icon", 

/* 15 */ "Name table (obsolete in 3.1)", 

/* 16 */ "Version info" 

¥ 
// read an ordinal number into ald, or an ASCIIZ string into aStr 
int RdHeadItem(char *aStr, int &aId, int hFile) 


{ 
char ch; 
if (_read(hFile, &aStr[@], 1) != 1) 
return 1; 
if (aStr[@] == '\xFF') // ordinal 
{ 
aStr[@] = @; // number, not name | 
_read(hFile, &aId, sizeof(int)); 
} 
else // name 
if (aStr[@] == 9) // invalid magic 
{ 
cout << "This is a Win32 .RES file\n"; 
exit (1); 
} 
ald = Q; // name, not number 
signed long pos = lseek(hFile, @, SEEK_CUR); // where are we? 
_read(hFile, aStrt1, 126); // probably read too much 
lseek(hFile, pos + strlen(aStr), SEEK_SET); // back up 
} 
return 0; 
} 
void main(int argc, char *argv[]) 
{ 


int hResFile, RId, Id; 

long ResLen; 

unsigned int Flgs; 

char st[128], sn[128]; 

if (arge != 2) 

{ 
cout << "Usage: Reslist resfile\n"; 
exit(1); 


} 
if ((hResFile = _open(argv[1], O_RDONLY) )) 
{ 
// get type: ordinal or string 
while (! RdHeadItem(st, RId, hResFile) ) 
if 


if (st[®) == 0) // ordinal number, not name 
{ 


if (RId <= LastResNum) 

strepy(st, StandardResName[RId-1]); 
else 
{ 

itoa(RId, st, 10); 

streat(st, " (user defined)"); 
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} 
else 
; // already have type string in st 
// get ID: ordinal or string 
RdHeadItem(sn, Id, hResFile) ; 
if (sn[@] == @) // ordinal number, not string 
{ . 
sn[Q] = '#'; 
itoa(Id, &sn[1], 10); 
} - 
// get memory flags 
_read(hResFile, &Flgs, sizeof(unsigned int)); 
// get length in bytes of following resource data 
_read(hResFile, &ResLen, sizeof(long)); 
// where are we in the file? 
// so we can output file offset of actual res data 
long pos = lseek(hResFile, %, SEEK_CUR) ; 
cout << st << ": "<< sn << " (" << RésLen - 
<< " bytes at ofs " << hex << pos << dec << "H)\n"; 
// in a genuine program, we would read in resource data 
// and switch on resource type in RId 
lseek(hResFile, ResLen, SEEK_CUR) ; 
i; 
_close(hResFile) ; 


Listing Three 


HGLOBAL LoadRESResource(LPCSTR ResFName, LPCSTR lpszName, LPCSTR lpszType) { 


char st [128], sn[128]; 

void huge *AddrTemp; 

long ResLen; 

HFILE hResFile; 

HGLOBAL hMem=0; 

WORD Flags, RId, Id, fndtyp = @; 


if (HIWORD(lpszType) == ®) fndtyp = LOWORD(lpszType) ; 

if ((hResFile = _lopen(ResFName, OF_READ)) == HFILE_ERROR) 
return 0; 

while(! RdHeadItem(st, RId, hResFile)) { // get type 
RdHeadItem(sn, Id, hResFile) ; / get name or ID 
_lread(hResFile, &Flags, sizeof(unsigned int)); // get flags 


_lread(hResFile, &ResLen, sizeof(long)); // get length 
if (fndtyp != @ && RId == fndtyp |} 
fndtyp == @ && stremp(lpszType, st) == 0) { // match type 
if (HIWORD(lpszName) != @ && strcmp(lpszName, sn) == @ j; 
Id == LOWORD(lpszName)) { © // match name 
if (! (hMem = GlobalAlloc (GMEM_FIXED, ResLen) )) 
return 9; 
if (! (AddrTemp = GlobalLock(hMem) ) ) { 
GlobalFree (hMem) ; 
return Q; 
} 


long count = @; 
unsigned portion; 
long len = ResLen - count; 
while (len) { 
portion = (len <= OxFFFF) ? len : OxFFFF; 
if (_lread(hResFile, (char huge *)AddrTempt+count, 


portion) != portion) { 
GlobalUnlock(hMem) ; 
GlobalFree (hMem) ; 
hMem = @; 
} 
count+=portion; 
} 
GlobalUnlock (hMem) ; 
break; // we found it! done! 


} 
} 
_llseek(hResFile, ResLen, SEEK_CUR); // to next resource entry 
} 
_lclose(hResFile) ; 
return hMem; 


Listing Four 


// LoadRESMenu() -- excerpted from READRES.CPP 
_HMENU LoadRESMenu(LPCSTR ResFileName, LPCSTR lpszMenuName) { 


HGLOBAL hTempMem; 
void far* AddrTemp; 
HMENU retMnu; 
if ((hTempMem = LoadRESResource(ResFileName, lpszMenuName, 
MAKEINTRESOURCE(RT_MENU))) != @) { 
if ((AddrTemp = GlobalLock(hTempMem)) != @) { 
retMnu = LoadMenuIndirect (AddrTemp) ; 
GlobalUnlock (hTempMem) ; 


} 
GlobalFree(hTempMem) ; 
} 
return retMnu; 
} 
End Listings 
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Candela’s Color Management System 
(CCMS) Library now supports the Mac- 
intosh Think C 5.0 compiler and 
Nextstep 3.0, SunSparc OS 4.1.3, DOS 
5.0, and Windows 3.1. 

CCMS Library includes linearizing and 
characterizing devices, color-gamut map- 
ping, and operation of test targets. The 
CCMS Evaluator helps to link and trans- 
form color among scanners, monitors, 
and output devices. 

The technology is based on nonlin- 
ear, nonseparable math functions that 
provide smooth color and gray tonal 
transitions while processing large image 
files that have millions of color pixels 
at fast speeds. CCMS costs $7500.00 and 
includes the Evaluator and API docu- 
mentation. Reader service no. 20. 
Candela Ltd. 

1676 E. Cliff Road 
Burnsville, MN 55337-1300 
612-894-8890 


The WinClient library is a C++ object 
library for Windows-based relational 
database management system (RDBMS) 
front-end application development. The 
library unifies programming styles for 
different windows, including MDI 
frame, MDI child, and ordinary win- 
dows. Windows initialization routines 
can be encapsulated in the application 
base class. A single language —C++, for 
example—can handle forms, reports, 
and large batch programs, and can share 
program logic between them. Reader ser- 
vice no. 21. 

WinClient Technologies 

411 University Street, Suite 1200 
Seattle, WA 98101 

206-623-0171 


MainWin, from Machine Independent 
Software, is a software-development kit 
for porting Microsoft Windows appli- 
cations (written in ANSI C) to UNIX 
(POSIX and X Windows). MainWin 
supports Solaris, UnixWare, AIX for 
RS/6000, and HP-UX. On the PC side, 
the first release supports Windows 3.0, 
with 3.1 support expected later this 
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year. The MainWin SDK is priced at 
$5000.00. Reader service no. 22. 
MainSoft 

185 Berry Street, Suite 5411 

San Francisco, CA 94107 

800-624-6946 


The Public Windows Interface (PWI), 
a specification that would put the Mi- 
crosoft Windows API into the public 
domain, has been proposed by Sun- 
Select (a Sun Microsystems business 
unit) and endorsed by a number of 
third-party companies, among them 
Borland, Corel, HP, IBM, Quarterdeck, 
SCO, USL, and Wordperfect. As pro- 
posed, the PWI standard would enable 
the development of applications and 
tools so that users of systems based on 
multiple operating systems could run 
Windows apps. 

As you might expect, however, Mi- 
crosoft is not included on an endorse- 
ment list. A Microsoft spokesperson told 
told DDJ: 


Sun’s actions are basically irrelevant. There’s 
a known and well-published Windows in- 
terface today, certainly more broadly pub- 
lished and broadly documented than any- 
thing that Sun or another UNIX vendor has 
to offer. 

We have an Open Process whereby we 
review all the new proposed API specs...with 
the industry well in advance before the APIs 
are done, solicit feedback, and make 
changes if necessary to meet people’s needs. 
The process combinels] the speed from lead- 
ership...with an open process that makes 
sure that, in fact, we’re doing the right thing. 

We do not frankly believe that Sun has 
any intention of doing right by the users of 
Windows or Windows itself. Clearly, the 
only economic benefit Sun might hope to 
derive is to fragment the Windows interface 
the way the UNIX interface and the UNIX 
API is fragmented in the hope they can con- 
tinue to participate in a market that seems 


to have already selected Windows. 
We don’t understand what the benefit 


would be of taking a Windows standard 
that’s now supported by 25 million people 
and countless thousands of software de- 
velopers and...fragmenting it or turning it 
over to a body that essentially consists of 
hostile UNIX competitors. 

If they’ve finally acknowledged that you 
have to support the Windows interface in 
order to be a player in the market, we’re 
tickled. 


For information on PWI, contact Sun- 
Select. Reader service no. 23. 
SunSelect 
Two Elizabeth Dr. 

Chelmsford, MA 01824-4195 
508-442-0000 


Also new from SunSelect is a software 
technology called “WABI” that makes it 
possible for UNIX users to directly run 


Microsoft Windows apps on UNIX-based 
PCs and workstations. Because the Win- 
dows apps are part of the UNIX desk- 
top, users can cut-and-paste between 
Windows and UNIX apps. WABI (pre- 
sumably short for “Windows Applica- 
tion Binary Interface”) is not Window 
emulation; it translates Windows func- 
tion calls into X Windows calls. WABI, 
which was originally developed by 
Praxsys Technologies, includes bit- 
streams font handling Gincluding True- 
Type fonts). 

WABI has so far been licensed by 
USL, SCO, and SunSoft. SunSelect has 
set up a self-certification program, 
whereby developers can receive a free 
preview copy of WABI for conducting 
compatibility testing during application 
development. Reader service no. 24. 
SunSelect 
Two Elizabeth Dr. 

Chelmsford, MA 01824-4195 
508-442-0000 


NeuroForecaster, a neuro-fuzzy network 
program from NIBS Pte, provides in- 
vestment analysis for stocks, options, 
fixed-income securities, foreign ex- 
change, interest rates, and so on. It uses 
only historical data for training, so ex- 
plicit expert rules aren’t needed. The 
program provides time-series forecast- 
ing, cross-sectional classification, and 
indicator analysis. Forecasts can be built 
with any number of input and user- 
specified complexity, limited only by 
the amount of computer memory. 
Twelve built-in neural-network models 
include backpropagation, radial-basis 
function, and neuro-fuzzy models. 
Rescaled range analysis is included to 
help the user predetermine the pre- 
dictability of the input data, and to re- 
veal hidden cycles in the time series. 
NeuroForcaster 2.1 for Windows or the 
Macintosh sells for $350.00. Reader ser- 
vice no. 25. 

NIBS Pte Ltd. 

62 Fowlie Road 

Republic of Singapore 1542 
+05-344-2357 


Visual Basic 3.0 has been released by 
Microsoft. The two major 3.0 enhance- 
ments are integration of the Microsoft 
Access 1.1 database engine and support 
for OLE 2.0 Automation. The database 
engine provides direct access to Access, 
dBase, Paradox, Btrieve, and ODBC. 
(ODBC drivers for Microsoft SQL Serv- 
er, Sybase SQL Server, and Oracle are 
provided.) The engine has multiuser 
support, transaction processing, and sup- 
port for rich data types (sound, video, 
OLE objects, and pictures). OLE 2.0 au- 
tomation lets you build custom pro- 

(continued on page 159) 
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ASSEMBLY LANGUAGE 


Assembly Language Tools 
ASMFLOW Professional automatically pro- 
duces flow charts and tree diagrams from 
assembly source. Also generates register 
usage analysis, x-ref, timing info and more. 
Available for 80x86, 8051, 8085, 8096, Z-80, 
68HC11 and 1750A. ($199.95) Call for free 


demo and catalog of assembly, TSR and float- 
ing point libraries. ($99.95 to $299.95) 


Quantasm Corp. 
19672 Stevens Creek Blvd #307 
Cupertino, CA 95014 
800-765-8086 or 408-244-6826 
FAX: 408-244-7268 
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CASE TOOLS 
Class Diagram —> C++ 


With Class ($149)— Use Rumbaugh, Shlaer-Mellor, Booch, or 
Coad-Yourdon constructs to design soft- 
ware and generate C++ code under MS 
Windows environment. Also reverses 
generated code back to diagram. 


StateMaker ($69)— —_ Drew state diagram and generate C code 
under MS Windows. Reverse state engine 
back to diagram. 
















Both tools included for all attendees at inhouse 
“OOD with C++” training course. 


Call 1-800-845-9348 to order. VS/MC accepted. 


MicroGold Software 
696 Birch Hill Dr. 

Bridgewater, N.J. 08807 
1-908-722-6438 
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C CD-ROM ___—CO#” 
Walnut Creek CDROM 


Source Code CDROM $39.95* 
600 meg of C, Pascal, Asm. for Unix and DOS. Mostly C. 
Lots of Pascal, C++, Fortran, etc. Made in March 1992. 


Simtel CDROM $24.95* 
640 meg, 9000+ files. Programming tools, DOS utilities, 
comm, BBS publishing, and more! Made in May 1993. 
CICA MS Windows CDROM $24.95* 
Thousands of MS Windows programs. Made in April 1993. 


*Shareware requires separate payment to authors if found useful. 


at * te 



















Full money-back 
guarantee 
VISA/MC/AE/COD 


1-800-786-9907 * +1-510-674-0783 *& FAX +1-510-674-0821 
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COMPILERS 


Thompson Toolkit plus 
AWK Compiler Version 2.0 





Features over 100 UNIX like utilities plus our AWK 
Compiler to make programming easy and fun again. 
New! AWK Version 2.0 allows your AWK 


program to directly call C functions! Thompson AWK 
has many new features including EMS/XMS support. 


Thompson Call for Complete Literature 


Automation 1-800-944-0139 
—————s AK IO eo 200 


5616 SW Jeff 
serene) Overseas: 503-224-1639 
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CONVERSIONS DEVELOPMENT TOOLS 


BAS_C v6.0 translates BASICA/QBASIC/ Pct 

Quick BASIC source code to C source World s best indexed collections of PD/Shareware for PC 

code automatically. The translated C pros since 1984. ZIPed (2.04G) and scanned. 30 day guaran- 

source code is scoped indented. struc- tee. MC/Visa/AmEx/Disc/COD Free brochure. 

tured, syntax error free and can be com- Product ___MB/Files_Trice a 
: ; CD-ROM w Any/All — $59/195 12/384 $59.50 

piled Turbo/Borland/Microsoft/Quick C. C eu914 $149 20/321 $59.50 

Runtime C source code is available. ied th ae, ee eee 

90% conversion ratio. $480/955. PC Products Database $25.00 TurboPascal 22/664 ~—- $79.50 

VisualBASIC 14/371 $59.50 Windows Pro 59/637 $99.50 


Gotoless Coversions os/2 16/243 $59.50 + VB/PDS/QB_ 15/219‘ $59.50 
7105 Dee Cole Dr. TrueType 21/752 $59.50 Access DBMS 5/101 $59.50 


“Otay eoe-o303° EMS Professional Shareware Libraries 


BBS: (214) 625-6905 FAX: (214) 370-2612 4505 Buckhurst Ct., Olney, MD 20832 
Tel: (301) 924-3594, Fax: (301) 963-2708 
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DATA COMPRESSION 
Ms-D0S DATA COMPRESSION 05/2 
SICK OF YACC?? 
Switch to LALR. Extended BNF grammar notation, interactive 


Windows TOOLKIT Source 
grammar debugger, automatic error recovery, abstract syntax 


Cx 1.50 
Compare with ANY other data compression tool. tree construction, blazingly fast. Includes YACC translator and 
sample grammers for Ada, BASIC, C, C++, COBOL, dBase, 


Faster and smaller than LZ* schemes. Buffer 
based interface usable with most languages (C, FORTRAN, Modula-2, Pascal, PL/1, PL/M, SQL, others. 
Supports DOS/Windows/0S/2 


60 Day Money Back Guarantee 
Call For Technical White Paper, 
Benchmarks, And Free Demo Disk 


MicroQuill Software Publishing, Inc. 
4900 25th Ave. NE #206 Seattle, WA 98705 
800-441-7822/206-525-8218 fax 206-525-8309 
CompuServe: 70751 ,2443 Internet: mcuster@microquill.win.net 














C++, Pascal, BASIC, VB, ...). Emphasize speed or 
size. No royalties. 30 day money back guarantee. 
We work with you to make Cx work for you. 


$95/$195 with source Four Lakes Computing 
608-256-3382 1135 Williamson #4 
CIS: 70662, 2501 VI/MC Madison, WI 53703 
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Don’t Write Printer Drivers! 


Need the ability to print what’s on the screen? 
EGAD Screen Print supports popular matrix, laser, 
and inkjet printers. Color printers too. Call from 
your program — select crop area, print colors or 
gray tones, orientation, alignment, etc. Print from 
up to 800x600 Super VGA. Single copy $35.00 
No Royalty license, $350.00. 
Free brochure, call 602/380-9175. 


LS Software 


8139 E. Mawson Rd. 
Mesa, AZ 85207 
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TOOLS FROM SPACE! 


Use NASA-Developed Source Code in Your 
Next Program. C & C++ Source Code for NQS, 
NASA’s X Windows/Motif-Based GUI Builder, 
AI, UNIX Utilities, Sci Vis, and more! 


OSMIC 


Athens, Georgia 
706-542-3265 
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Barking Spider Controls For Windows 


Tree Control — This lightning fast control draws and manages 
displayed trees. Graphics and text can be assigned to each node. 
Graphic Listbox — This control finally gives you a listbox that displays 
graphics as well as text, without the pain. 

Features: The Controls handle Scrolling, Painting, User input, 
management of application data and more! 


Fast and Small! Drag and Drop Support! 
Minimal selector use! Uses icons/bitmaps! 
32K items! No Royalties!! 


Barking Spider Software, Inc. 
TEL (503) 324-0187 TEL/FAX: (503) 629-8236 


BBS: (503) 324-0227 
Download our Demos Call for more info Today! 
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DEVELOPMENT TOOLS 


Computer Aided Protocol Engineering 
(CAPE) Real Time CASE Tools 


Bayfront's CAPE Tools capture the design, generate C 
code, and draw state, state/event transition, and CCITT 
SDL diagrams for any software system that uses protocols, 
state machines or timed control. The CAPE Tools are used 
to create communications, real-time, or client/server 
systems running under DOS, Unix, Windows, OS/2, 
Windows NT or embedded platforms. No royalties. For 
sales & Information call 714.436.0322x104. 

Windows 3.1 $550, DOS $550, Unix $650 

DOS/Windows 3.1 Demo $45 
Bayfront Technologies, Inc. 
1280 Bison B9-231 
Newport Beach, CA 92660 
Voice/Fax 714.436.0322 
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DISASSEMBLERS 






UNIVERSAL 
CROSS-DISASSEMBLER 


Missing Source? Upgrading an unsupported product? 

The XDASM is your solution. 

= Produces “Assembler Ready” source code 

= Accepts Intel hex, Motorola S and binary file formats 

= Uses manufacturer's assembly language mnemonics 

a User configurable assembler directives 

= Generates label names and cross-reference tables 

= Deblocks source code into subroutines 

= Full control of disassembly with TAG file 

= Over 30 processor tables included 

a Users may create tables for other microprocessors/ 
microcontrollers 

a Easy-to-understand table language 

a= Unlimited table updates from our BBS 

= Requires MS-DOS PC with 512k RAM 

Free demo software on BBS. Universal Meta / Macro 

Assemblers available. 


XDASM V2.1 $249. VISA/MC/PO/COD 






















DATA SYNC ENGINEERING 
P.O. Box 146 
East Stroudsburg, PA 18301 
TEL (717) 421-1977 © FAX (717) 421-9095 
BBS (717) 424-6754 (1200/2400,N,8,1) 
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B.S. & MLS. 


Gem Oeltivamere(siac, 


e ALL COURSES HOME STUDY. 
e Approved for tuition reimbursement by leading 
corporations. 


AMERICAN 


INSTITUTE 


COMPUTER 
SCIENCES 


Direct-Fax™” API 


The easy to use FAX API for C programmers. Send 
faxes directly from your applications. A single func- 
tion call transmits a fax. Support for ASCII text and 
PCX or DCX graphics formats. Scheduling and group 
support. For CAS compatible fax modems. All memo- 
ry models, BC and MSC. Libraries $129.00 ($199.00 
with source) plus $7.00 shipping ($25.00 overseas). 
VISA/MC accepted. 


LOGAN INDUSTRIES, INC. 
604 Mango Drive 
Melbourne Beach, FL 32951 
Voice: (407) 984-1627 
Fax: (407) 951-7292 


¢ Most courses interactive. 

e Approved Ada course available. 
For free information call 
1-800-767-2427 or write: 
2101-DJ Magnolia Ave. 

Suite 200 © B’ham, AL 35205 
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FORTRAN TOOLS 
_The SPINDRIFT Libra 


Now your FORTRAN programs can: 

© Control the KEYBOARD, SCREEN, MOUSE and DOS 

© Have DIALOG BOXES, scrolling LIST BOXES, 
pull-down MENUS, mouse PUSH BUTTONS, 


Specify your 
FORTRAN Compiler. 


HELP PANELS, etc. PRICE: 
$149 for 16 Bit Compilers 
$289 for 32 Bit Compilers 


© Execute other programs or perform DOS commands 
© Check printer ies disk status 
© Much more! Approximately 200 subroutines 
and functions for directory operations, 
color screens, date/time, encryption, sorting, 
wildcard file searches, security, ett. 


Use these routines to give your programs a 
state-of-the-art user interface. 


The Library includes demonstration programs Phone: (708) 255-6909 
that show how to implement these features. FAX: (708) 255-6101 


CIRCLE NO. 1123 ON READER SERVICE CARD 


Spindrif 
Laboratories, Ltd. 
116 South Harvard Avenue 

Ariington Heights, IL 60005 USA 





Indispensable Tools 
For Serious Programmers! 


FORTRAN DEVELOPMENT 
TOOLS $149 

¢ Find structure in your programs 
¢ Clean up old, ugly Fortran code 


FORWARN $399 
¢ Save time and aggravation 


¢ Find bugs faster 
¢ Better understand large 
programs 


— 
For DOS, Also lor DOS pl otected U 2 Us 


mode. 012, Unix, and VMS. 
30 Day Money Back Guarantee! 


ENTERPRISES, INC. 
3340 Marble Terrace © Colorado Springs, CO 80906 © (719) 527-1384 
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GRAPHICS LIBRARIES 





Victor Library for C programmers. Powerful image process- 
ing & color reduction, bright/contrast, sharpen, outline, 
resize, overlay, matrix conv., etc. TIFF/PCX/GIF/TGA/bin, use 
exten'd, expan’d, conv mem, 8-bit/24-bit images, any size, 
grays, color, EGA/VGA, up to 1024x768x256, LaserJet, 
ScanJet+, for MSC, QuickC, Turbo C/C++. Source avail, no royal. 
VICTOR LIBRARY, V2.2 $195 
CATENARY SYSTEMS 
470 BELLEVIEW ST LOUIS MO 63119 


VISA/MG CALL/FAX (314) 962-7833 cop 
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ViewPoint” 
The fastest, most powerful, 
|and easiest to use graphics 
library available. 


C++ Only. Non-crippled trial version 
available for only $5. 









| For DOS, Borland and Microsoft compilers. Specify disk 
| size and compiler (brand and version). Trial version is small 
model library only. Full source code included in Pro version. 


| Dlugosz Software e Box 2335 « Warminster PA 18974 | 
| Voice/Fax: (215) 343-6813 ¢ BBS: (215) 957-9779 
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Wa\lmelm (alm Om -lale[er-(e(-Mcele] al-t-m ele mal-l-1em MN Elt-) 
an impressive scientific graphing program of your 
PC Magazine 3/14/89 


own. Highly recommended.” 


Shaded contour & 3-D plots; polar contour plots. 

Color PostScript®and EPS. Color separations 

Export HP-GL(/2), TIFF, GEM, CGM, PIC, SCODL, & Tektronix files. 
Linear, log, error function plots, Smith , bar, triangle & pie charts. 


Source code for complete control. 


fe 
9 
a= 
9g 
2 

£6 
4. 


NEW!! Windows version allows you to do graphics in 
Windows with no Windows programming knowledge. 
Licensed for personal use only. Reasonable license terms available. 


Scientific Endeavors Corporation 


GRAPHICS LIBRARIES 


ALL SOURCE CODE INCLUDED! 


Real mode version only $249, Protected mode version $499. 
TEGL Windows Toolkit lets you create DOS based GUI apps 
that are completely standalone. Over 500 functions. Menus, 
mouse and keyboard support, dialogues, and more. Includes 
TEGL Graphics Interface (BGI function compatible) which 
supports most popular video modes including Super VGA and 
256 colors. Font and icon editors included along with over 250 
fonts. Compilers: Turbo and StonyBrook Pascal, Borland, 
Intel, Microsoft, Topspeed, Turbo, WATCOM and Zortec C. 


TEGL Systems Corporation 
P.O. Box 580, Stn. A, 
Vancouver B.C. CANADA V6C 2N2 
(604) 669-2577, Fax (604) 688-9530 
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LIBRARIES 


INCORPORATE SOUND BLASTER 
AND ADLIB INTO YOUR SOFTWARE 


The WORX programmers toolkit will allow you to easily incorporate sound 
and music into your software without having to struggle with low level 
code and compatibility problems. Plays back standard MIDI files, CMF 
files and VOC sample files fully in the background. This toolkit is a link- 
able library which takes less than 20K of code, and requires no drivers or 
TSR's. Autodetects Sound Blaster configuration. No royalties, and updates 
are always free. Worx+ will allow you to play up to eight channels of sam- 
ples fully in the background with FM music. Call for more information. 

Available for Borland, Turbo C, Pascal and Microsoft C. 

WORX 2.01: $79.00 © Worx+ 1.0: $199.00 


Mystic SOFTWARE 
1504 Encinal Avenue, Suite D, Alameda, CA 94501 
Voice: (510) 865-9189 Demos/BBS: (510) 865-3856 
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C-HEAP From Library Technologies, for Borland/ 

Microsoft C/C++ satisfies all your memory manage- 

ment needs, and then some: 

, page frame, through malloc() ¢ utilize 
¢ functions up to 1200 

times faster and 10 times as efficient as malloc () 

reduce memory fragmentation, with a 

() © much more — over 500 functions. Call for info. 


Libraries Technologies 
P.O. Box 56081 * Madison 53705 
800-767-4214¢ 608-274-4224 ¢ fax 608-833-1171 
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Access 


PGL - Printer Graphics Libraries 


The PGL ToolKit is a set of easy to use 
libraries for generating device independent, 
alfelac=xcxe) 6 1(e)ame]¢>1e)alexcmel¥)ielUlmelamanreysim ele) e lel t-ls 
printers. Includes full support for C/C++, 
Fortran, Basic, Pascal, Clipper, & Assembly 


plus 32-bit support for C and Fortran. NO 
ROYALTIES! 


Only $245 (includes all language support) 
Source code available: $595 


AnSoft, Inc. Voice/FAX: (301) 470-2335 
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Bridge Traffic by Usage 





508 N. Kentucky St., Kingston, TN 37763 
Orders: (800) 998-1571 FAX: (615) 376-1571 
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SCIENTIFIC AND ENGINEERING LIBRARIES 


1992 Computer Language Productivity Award Winner 





M++ provides a complete (++ math library with powerful multidimen- 
sional array handling capabilities. M++ includes 


© LINPACK linear systems code © Support for huge arrays 

© EISPACK eigensystem code ¢ Generalized outer operations 
e FFT, convolution, and FIR/IIR methods © Advanced modules available 
© Indexing and sub-array operations 










M++ reduces code size and programming time providing efficient han- 
dling of arrays, matrices and vectors. Available on UNIX, DOS, NT and 
05/2 systems starting as low as $295. 


Dyad Software Corporation 
515 116th Ave NE, Suite 120 ¢ Bellevue WA 98004 
(800) 366-1573 (U.S. only) © (206) 637-9426 FAX 
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Data Structures 


for all Turbo Pascal programmers 





The Data Structures object library provides you with all of 
the data structures you need most: 


VY Deques, Stacks, & Queues 

V Lists (unsorted, sorted, unique key) 

VY Trees, Heaps, & Priority Queues 

VY Sparse matrices, Huffman encoding, & more! 









Example programs, on-line help, source code, and a 200+ page 
manual get you up to speed quick. For Windows and DOS. 


$49.95 
(617) 232 - 6951 
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MARKETING 
MARKET YOUR SOFTWARE 


Whether you wish to license your software to an existing 
publisher, or form your own software company, we can help. 
We will provide legal and business services including product 

and market analysis, selection and solicitation of potential 

licensees, license negotiation, drafting and analysis of all 
contracts, incorporation, writing of business plans, and filing 
of financing applications. If your venture is a success we all 
profit, if it fails, you owe us nothing for our services. 













Natural Systems 
P.0.Box 968, Brookline, MA 02146 














Call or write today. No obligation. Confidential. 
Do not send any software or ideas to us or anyone without a 
signed non-disclosure agreement! 







Michael Norman Saleman, Attorney at Law 


Rayman & Associates Consultin 
15910 Ventura Blvd., Suite 801A, Encino, CA 91436 


v: 818/379-8770 f: 818/379-8780 CIS: 71401,1653 
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"sto be featured once again 
in the October issue 
of Dr. Dobb’s Journal. 
Product Showcase offers 
1/8 page four-color ad — $550 
Space close: July 23, 1993 


mOHtSr WVamMADSe = 


OOPSLA ’93 and Embedded 


Systems Conference 
Contact Cheryl Canion 
(415) 358-9500 ext. 306 
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MARKETING SECURITY 


CRYPKEY SOFTWARE LICENSING SYSTEM 


“Hardware key like protection without the hardware key” 
CrypKey is a Software protection tool, offering 
= complete security from any disk copy program 
» complete compatibility with any MS DOS 
or MSWINDOWS31 based machine 







Your sales message in the PROGRAMMER’S POWER PACK card deck wil: 


mw Reach 150,000 subscribers of Dr. Dobb’s Journal and Software 
Development magazine 
m Reach technical buyers with purchasing authority 
— 87% are involved in purchasing software for their companies 
mw Reach proven direct mail buyers 
— 687% buy software directly from the manufacturer 


The PROGRAMMER’S POWER PACK is the only low cost yet targeted 
medium available to generate quality leads and direct sales. 







» complete invisibility—no disk key, no hardware key, less support calls 
» instant disaster recovery 
CrypKey is a Sales tool, allowing you to sell your program 
« by increments—enable the options the customer purchased 
« by number of runs—e.g., sell 100 calculations for $499.00 
« Dy time period—e.g., lease or demo your program for 60 days 
CrypKey uses a numeric key that can be transmitted by phone or fax. 
Sell your customers more options, more copies, more time or more runs instantly, 
just by making a telephone call. (Great for overseas customers or distributors.) 


“NOW AVAILABLE FOR NETWORKS” 


CRYPKEY IS PRODUCED BY KENONIC CONTROL—ENGINEERING AND SOFTWARE SINCE 1972 
Kenonic Controls Limited ¢ 7175 - 12th Street South East ¢ Calgary, 
Alberta, Canada T2H 2S6 © (403) 258-6200 © fax: (403) 258-6201 
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NETWORK 


The $25 Network 


Try the Ist truly low cost LAN 
Connect 2 or 3 PCs, Xts, ATs, PS/2s, 386s 
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Opt-Tech Sort 


High Performance Sort/Merge/Select Utility. Run from the 
command line or Call as a subroutine to your programs. 

Supports most languages and filetypes. Unlimited file size, 
multiple keys and much more! New Version 5.0 includes 










More Speed and More Features! 
MS-DOS or Windows $149 - 0S/2 or Unix $249 


(702) 588-3737 


Opt-Tech Data Processing 
P.O. Box 678 * Zephyr Cove NV 89448 
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SOURCECODE BROWSER 


eee 


Pop-up C & C++ browsing and 
analysis with cross referencing in 
your own editor! 


The original and the best! 


Western Wares 
(303) 327-4898 
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REACH OVER 115,000 
DEVELOPERS 


for just pennies 
per reader through 
DDJ’s Marketplace. 
Contact Cheryl Canion for more 
information (415) 358-9500 

























; Uses serial ports and 5 wire null modem cable 
Runs at 115K baud, up to 90 feet 
Share any device, any file, any time 
Needs only 14K of ram 
Skeptical? We make believers! 
= Information Modes 
inorlet 817-387-3339 Technical, 7 days 
1-800 628-7992 Orders 
RECRUITMENT 
C, C++, OOP, GUI, Motif, Sybase, Windows, 
LISP, Event Driven Programming, Compiler 
Hey! How far do we have to go with this list? 
Call or fax us at: 
P.O. Box 39 Voice: 413/256-1030 
Amherst, MA 01004-0398 Fax: 413/256-8582 


* 
* 
: Runs in background, totally transparent 
* 
: Version 2.31 * Over 15,000 SOLD 
P.O. Drawer F, Denton, TX 76202 
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Development, Device Driver Development... 
. THE SHAY GROUP 
Fee Paid By Employer 
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The New Professional Network 


Navigate the unadvertised job market 
with our FREE bulletin board 


Access to hundreds of today’s hottest jobs 
in Software and DP, coast to coast. 


Free career guides and resources. 
Direct dial (8-N-1) 413-549-8136 


Call or send your résumé in confidence to: 


Allen Davis & Associates, National Technical Search 
PO Box 2007 « Amherst, MA 01004-2007 


tel: 413-549-7440 « fax: 413-549-7542 


Client companies pay allfees. 
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SECURITY 








C and C++ DOCUMENTATION TOOLS 


rap ic-tree of caller/called function 
hierarchy, function/files index, function cross-reference. 
Creates/inserts comment-blocks (func- 
tions/identifiers used) for each function. 
Calculates path complexity, 
counts lines with comments, code, and ‘C’ statements. 
Lists and action-diagrams, or reformats 
source into user selected standard formats. 





Since 1986, thousands of companies worldwide 

have chosen Az-Tech Software as partners in 
their fight against Software Pirates. Why? 
Because we offer you proven leaders: 

EVERLOCK 3.0 SOFTWARE COPY PROTECTION 


Option Board Safe—Remote Registration 
New CPU LOCK-CD ROM LOCK and more 


EVERKEY HARDWARE LOCKS 







Creates CaN oe Genel Net 






cross-reference, C++ class hierarchy tree. 
* Special: C-DOC ($199) All 5 in 1 DOS (<15,000 lines) 
¢ C-DOC Professional ($299) DOS, OS2, Windows 
Processes 150,000+ lines, enhanced 3-ring binder. 


SOFTWARE BLACKSMITHS INC. | 


E 
Missisaanue, ONT Voice/Fax: (416) 858-4466 
Demos/BBS: (416) 858-1916 










Az-Tech Software, Inc. 
201 East Franklin, Richmond, MO 64085 
(816) 776-2700 Fax (816) 776-8398 


CIRCLE NO. 1139 ON READER SERVICE CARD 






Canada L5N-4M1 
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(continued from page 154) 

grams that take advantage of the capa- 

bilities of other OLE 2.0-compliant ap- 

plications. Other VB 3.0 enhancements 

include new controls, pop-up menus, 

data-access objects, data-aware controls, 

and integration of Crystal Reports 2.0. 
Visual Basic 3.0 sells for $199.00. 

Reader service no. 260. 

Microsoft Corp. 

One Microsoft Way 

Redmond, WA 98052-6399 

206-882-8080 


The Plug-In Components for Windows 
from Access Softek are DLLs that de- 
velopers can snap into Windows appli- 
cations. Among those recently released 
by Access are: P.J. Edit Control, which 
replaces the Windows Edit Control 
for WYSIWYG multiline edit boxes 
($495.00); P.I. Document Editor, which 
provides compound-document pro- 
cessing and reading and writing of RTF 
files ($995.00); P.I. Text Import/Export 
Filters for importing and exporting DOS, 
Microsoft Word, and Wordperfect files 
($395.00); P.I. Bitmap Import Filters for 
importing TIFF, PCX, GIF, BMP, and EPS 
files ($695.00); and P.I. Vector Import 
Filters for importing DXF, CGM, WPG, 
WMF, GEM, Lotus PIC, HPGL, and DRW 
files ($695.00). Reader service no. 27. 
Access Softek 

2550 9th Street, #206 

Berkeley, CA 94710 

510-848-0606 


A standard specification for ink as a data 
type has been proposed by pen-based 
developers GO, General Magic, Slate, 
Microsoft, Lotus, and Apple. The spec- 
ification, called “Jot,” defines a common 
format to be used for the storage and 
interchange of electronic ink data. Jot, 
which is written in C but which can be 
implemented in any language, is a 
record-based format that covers prop- 
erties such as: multiple ink strokes com- 
bined into single objects, bounds, scales, 
offsets, color, pen tips, timing, height of 
pen over digitizer, stylus-tip force, sty- 
lus buttons, and x and y angle of sty- 
lus. Forty-seven additional record types 
have been reserved for future use. Read- 
er service no. 28. 

Slate Corporation 

15035 North 73rd Street 

Scottsdale, AZ 85260 

602-443-7322 


Logivolve combines neural networks and 
genetic algorithms into one package, 
making it possible to develop neural- 
network systems without trial-by-trial train- 
ing. The packet comes as a programmer's 
library with several functions and is avail- 
able for Visual Basic and C. Logivolve for 
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C, with source, sells for $459.00, and for 
Visual Basic it costs $259.00. Reader ser- 
vice no. 29. 

Scientific Consultant Services 

20 Stagecoach Road 

Selden, NY 11784 

516-696-3333 


Tired of sitting through a 30-to 50-disk 
installation process—and sometimes 
having to start over because of an er- 
ror? This problem is solved by the LAN 
Configuration Facility (LCF), an auto- 
mated software-installation utility which 
allows large installations to be per- 
formed over a network. LCF, which is 
distributed by ForeFront Software, was 
developed by the Royal Bank of Cana- 
da, where it was used for the installa- 
tion and configuration of OS/2 mission- 
critical applications; LCF is capable of 
distributing, installing, and configuring 
DOS and Windows apps as well. 

LCF stores software in a central library 
on a server, where it can either be 
“pulled” by users or “pushed” by ad- 
ministrators from the server to unat- 
tended workstations. Server software 
sells for $500.00 (usually one server per 
network is required, although you can 
bridge from one LAN to another), while 
client software sells for $50.00/work- 
station. Reader service no. 30. 
ForeFront Software 
2202 2 Ave. NW 
Calgary, Alberta 
Canada T2N 0G9 
403-531-2160 


The Development Tools Handbook: Sup- 

port Solutions for the Intel MCS-51, MCS- 
96, and 80C186, a new book for em- 
bedded-systems designers, has been 
released by Market Works. The Hand- 
book lists suppliers of development tools 
and products that support Intel’s mi- 
crocontrollers. The 136-page book 
contains product data sheets and des- 
criptions of hardware and software- 
development tools such as in-circuit 
emulators, compilers and assemblers, 
debuggers, real-time operating systems, 
logic analyzers, and boards. 

The Handbook also details individu- 
al Intel embedded microcontrollers in 
terms of on-chip peripherals and mem- 
ory, power consumption, packaging, 
and special features. Copies of the 
Handbook sell for $24.00. Reader ser- 
vice no. 31. 

Market Works 

50 W. San Fernando, Suite 675 
San Jose, CA 95113 
408-286-4200 


VBAssist 3.0, a Visual Basic 3.0 add-on 
tool from Sheridan Software, lets de- 
velopers design forms for database ap- 


plications using drag-and-drop to link 
table columns to bound controls. VB- 
Assist’s Data Assistant opens a window 
showing all fields in the database as- 
sociated with the bound data control. 
With a mouse click on the desired field, 
the user drags and drops it into the tar- 
get control. It also allows developers 
to create and modify table structures, 
and view/modify data for any table. 
VBAssist 3.0 sells for $179.00; upgrades 
are $39.00. 

Sheridan is also offering 3D Widgets, 
a Visual C++ add-on that provides cus- 
tom controls such as list boxes, com- 
mand buttons, ribbon buttons, versatile 
panels, and specialized file, directory 
and drive list boxes. 3D Widgets costs 
$109.00. Reader service no. 32. 
Sheridan Software Systems 
65 Maxess Road 
Melville, NY 11747 
516-753-0985 


In further support of its pSOS+ real-time 
operating system for embedded appli- 
cations, Integrated Systems has extend- 
ed the pSOSystem C++ development 
environment by providing an “object 
register” garbage collector for more ef- 
ficient memory management, a source- 
code and class-library browser for un- 
derstanding complex programs, and 
support for 386/486 processors. Host 
systems include Sun, HP, DEC, and IBM 
workstations as well as PCs. Target pro- 
cessors include the Motorola 68x00 fam- 
ily, Intel i960, and Intel 386/486. Read- 
er service no. 33. 

Integrated Systems 

3260 Jay Street 

Santa Clara, CA 95054-3309 
408-980-1500 


RockWare Scientific Software has re- 
leased Z-CON, a mapping and con- 
touring application designed for Win- 
dows. Z-CON creates publication-quality 
maps from randomly distributed data 
points. Features include automatic con- 
tour smoothing and labeling, control- 
point plotting, and border annotation. 
Maps can be exported to .DXF format 
or to the Windows clipboard for use 
within spreadsheets, paint programs, or 
desktop-publishing applications. Z-CON 
sells for $79.95. Reader service no. 34. 
RockWare Scientific Software 

4251 Kipling Street, Suite 595 

Wheat Ridge, CO 80033 

303-423-5645 
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The Great Letter Shortage 


he pool is finally done and summer is here. Unfortunately, the pool attracts mosquitoes. And 
my cousin Corbett. 

The pool is attractively situated in a madrone grove. Madrones are beautiful trees with three 
distinct seasons. First, they drop berries, billions of berries that cover the ground like snow and 
then rot and attract fruit flies. Then there’s leaf-fall, which actually comes twice a year in California. 
Finally there’s the period when all the bark peels off in ticket-stub-sized pieces that smell like 
salami. 

This was berry season, and cousin Corbett had volunteered to sweep madrone berries off the 
pool deck, but he was instead pacing furiously up and down the deck, and the broom was 
nowhere in sight. I was sitting in a deck chair with the portable, working on my column, my few 
square inches of exposed skin white with sunscreen and Avon Skin-So-Soft. 

Here’s a tip: The best mosquito repellent in the world is Avon Skin-So-Soft. I know an Avon lady 
who sells it to lumberjacks and deer hunters in northern Wisconsin, and she told me so. 

“Where’s the broom?” I asked. 

Corbett was fuming. “I don’t know. I put it down somewhere. Do you know what they did to 
me now?” 

I didn’t much care. “You’re walking on the madrone berries.” 

“They ripped me off again. It’s all this task-based computing stuff. Microsoft has its OLE and 
Apple has its Amber and NeXT has its NeXTstep and Taligent has its Taligent....” 

“You're not claiming that you came up with that technology?” 

“No, but I did try to trademark the word ‘task’.” 

“Corbett, you can’t trademark a common word like that. Listen to me: When you walk on the 
berries, you grind them into the deck.” 

“Sure you can. I should have had a killer intellectual property infringement suit, but they ripped 
me off.” He picked up a rock and tossed it pensively into the pool. 

“Corbett,” I snapped, “any suit over your intellectual property could be settled in small claims 
court.” 

Instead of shutting him up, this set him off in a new direction. 

“I wonder what the lower limit is on the size of an intellectual property? There are deals where 
you can buy one square inch of land; could you, say, sell your name?” 

I perked up. A MacUser editor had recently published some anagrams of my name in his 
column. Was there an intellectual property issue there? 

“Or individual letters,” Corbett went on, pacing faster. “I know Intel wanted to trademark 
lowercase i, but I see AT&T using it in ads these days. And Zilog wanted to trademark Z....” 

“...which everybody knows is the mark of Zorro,” I added. Then I recalled a billboard in San 
Francisco that had puzzled me recently. The company’s logo looked so familiar, yet I couldn’t 
place it. It finally hit me that a C in a circle ought to look familiar to a writer. “Can you trademark 
the copyright symbol?” I asked. 

“How about the trademark symbol? Ask the transcendental meditation people. But listen, it just 
occurred to me that this minimal intellectual property business is a crisis in the making for the 
entire world economy.” 

“What the devil are you talking about? And if you have to stamp your foot like that, could you 
find a spot with fewer berries?” 

He pointed an accusatory finger at me. “Are you aware that every stock ever listed on the New 
York Stock Exchange is given a unique four-letter code? That code is a kind of intellectual 
property, and it’s worth a lot.” 

“So what?” 

“So the number of possible codes is a finite limit on the number of possible stocks. We’re 
talking about a few million codes here, a meaningful limit. And you know that a limit doesn’t 
actually have to be reached to exert an inhibiting effect. The mere existence of a limit can be 
inhibiting, in this case inhibiting the growth of the economy.” He picked up the portable. “Do you 
have the White House’s CompuServe ID?” 

I walked over to the pool and stood looking down into the deep end. At least now I knew 


where he put the broom. 
¢ 


Michael Swaine 
editor-at-large 
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here is a good reason why 
your database language was 
developed in C. In fact, there 
are many good reasons. 


C code is small. C code is fast. C code is 
portable. C code is flexible. C is the 
language of choice for today's professional 
developer. With the growing complexity of 
database applications, C is a realistic 
alternative. Now with CodeBase 5.0, you 
can have all the functionality, simplicity and 
power of traditional database languages 
together with the benefits of C/C++. 


C speed - fast code, true executables... 


FoxPro, Clipper, and dBASE were written 
in C primarily for speed. But those compilers 
don't really compile, they combine imbedded 
language interpreters into your .EXE. Now 
that's slow. For dazzling performance you 
need the true executables of C. With 
CodeBase you get the real thing, C code. 
Consider the following statistics, from the 
publisher of Clipper: 





De ABASE IV 





raster 


"Sieve of Erastothenes' 
Benchmark for Prime Number Generation 


Shows C to be incredibly faster ! 


C size - small executables, 


no added overhead... 


FoxPro, Clipper and dBASE would like you 
to believe you need their entire development 
system to build database applications. But 


remember, those products are all written in 
C. So why do you need to lug all their extra 
code around? You don't. CodeBase is a 
complete DBMS, in C. No fat executables 
stuffed with unused code. No runtime 
modules. No royalties. Just quality C code. 
CodeBase is just what you need. 


C portability - ANSI C/C++ 
on every hardware platform... 


No other language exists on more platforms 
than C/C++. Why rewrite your entire 
application for DOS, Windows, Windows 
NT, OS/2 or UNIX? With CodeBase the 
complete C source code is included, so you 
can port to any platform with an ANSI C or 
C++ compiler. Now and in the future. 


dBASE Compatible data, index 
and memo files... 


You want the industry standard. You need 
compatibility. Sure, dBASE 1s the standard, 
but every dBASE compatible DBMS 
product uses its own unique index and memo 
file formats. Only CodeBase has them all: 
FoxPro (.cdx), Clipper (.ntx), dBASE IV 
(.mdx) and dBASE III (.ndx). Now it's your 
choice, we're compatible with you. 


Announcin 
CodeBase 5. 


The power of a complete DBMS, the benefits of C 


NEW - Multi-user sharing with 
FoxPro, Clipper and dBASE... 


Now your multi-user C/C++ programs can 
share data, index and memo files at the 
same time as concurrently running FoxPro, 
Clipper and dBASE programs. No 
incompatibilities. No waiting. 


NEW - Queries & Relations 
1000 times faster... 


CodeBase 5.0 now lets you query related 





data files with any logical dBASE expression. 
Our new Bit Optimization Technology 
(similar to FoxPro's Rushmore technology) 
uses index files to return a query on a 1/2 
million record data file in just a second. 
Automatically take advantage of this query 
performance by using our new CodeReporter: 
———— eee ee 
Eile Align Database Groups _Global_Print_Query Styles Help | 
Tite Objects: 1; Height 36.0Pomts + 


Product Sales Sum a Product Sales Summary 


Month; Header; Objects: 5; Height: 48.0 Points Nov, 1992 
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Quantity Value 
Database 63 $25,137.00 
Spread Sheet 58 $21,866.00 
Monthly Summary 121 $47,003.00 
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Value 





“4 Product Quantity 
|| Database 62 $24,862.00 
“| Spreed Sheet 53 $19,875.00 
‘| Monthly Summary 115 = $44,737.00 
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| Summary 


236 = $91,740.00 










To use CodeReporter, iiss 
simply draw your report, then include it in any 
program you write. Call 403/437-2410 now for 
your FREE working model of CodeReporter. 


New - Design complex reports 


in just minutes... 


Our new CodeReporter takes the painstaking 
work out of reports. Now simply design and 
draw reports interactively under Windows 3.1, 
then print or display them from any DOS, 
Windows or UNIX application. 


SPECIAL - FREE CodeReporter 
Order CodeBase 5 before September 30, 
1993 and receive CodeReporter for free! 
This offer includes our no-risk, 90-day 
money back guarantee, so order today! 


CodeBase 5.0 


The C/C++ Library for DataBase Management 


Call Now 
m 403-437-2410 
SEQUITER 


FAX 403°436°2999 
UK Tel. +44-81-317-4321 
SOFTWARE INC. 
P.O. Box 575 Newmarket NH 03857 





France +33.20.24.20.14 


©1992 Sequiter Software Inc. All rights reserved. CodeBase is a trademark of Sequiter Software Inc. All other trade names referenced herein are property of their respective companies. MAdvertising by MicroArts 
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To reach new heights _ 
in Macintosh programming, — 

. you need to stand on 
SY . big shoulders— 
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\ like C++ creator, The Fast Way 

)/ ‘ Bjarne Stroustrups. to Program Cr+02 : 

i , Introducing the Macintosh. - 
7 Symantec C++ for 


» Macintosh, the first 
* native C++ for Mac 
) developers with 
y innovations that give 
you an edge. 

Blazing speed, for instance. 
The edit/compile/run/debug 
loop is incredibly fast, thanks to 
our native C++ compiler and 
instant linker. No more coffee 











Project Manager. 











‘The three }reaks while your build cranks It really cuts down on 
most important away, Then there’s the integrated can use _ hassles. 
things about tis source code control system for team your favorite We know you loved THINK. 
P ses programming, so your group can editors and tools—and Nowit’s time to THINK again. C++ 
iid nite ‘A " . work as fast as the environment. automate processes using scripts. is the way of the future, and 
Tan use my z Our environment Symantec C++ for Macintosh is the 
favorite editors (Saas toss reve 7 supports ANSI C and product you need. 
and tools, oa the latest Apple System Symantec C++ for Macintosh. 
I’ve been waiting cesT 7 features, along with Now you can pick up something hot. 
for avery fast sre CFP the most recent For complete information via 
C++ for the Mac. versions of C++. In fax, call 1-800-554-4403, select op- 
And this is it!” addition, it has the tion #1 and request document #442. 
—Randy Hil , capacity to build the 
Software Engineer ing ag largest 
Claris Binclude <iostream.h> 





programs 
youre ever 
likely to 
need. And 
when youre writing 
tons of code, you'll 
appreciate our THINK 


void maint) 
{ 


cout << “Hello Symantec C++ 1" <¢ 


And Symantec C++ for Mac- 
intosh has a completely 
open architecture. You 








C++. It's 
got ability. 


Latest C'++ features, including templates. 
AppleEvents and scripting support. 
Improved debugging for huge applications. 


C++ version of THINK Class Library. 
Direct links to on-line THINK Reference. 








Symantec C++ is a trademark of Symantec Corporation. Valid in 
the U.S. and Canada only. For more information in Europe, 

call 31-71-353111. In Australia, call 612-879-6577. In Canada, call 
1-800-465-2266 Everywhere else outside U.S., call 408-252-3570. 
Bjarne Stroustrup does not endorse software products. 

©1993 Symantec Corporation. 
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